Registry / data / amalgam-lang

amalgam-lang

library29.0.1pypypi✓ verified 44d ago

Python bindings for the Amalgam language runtime, providing a direct interface with the compiled Amalgam shared library (.dll, .dylib, .so). Version 29.0.1 supports Python >=3.10. The library is actively maintained with frequent releases.

data ai-ml

pip install amalgam-lang==29.0.1

github ↗package ↗homepage ↗docs ↗

Install & Compatibility

Where this runs

tested against v29.0.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 12.4s

py 3.11

✓ —

✓ 10.2s

py 3.12

✓ —

✓ 2.9s

py 3.13

✓ —

✓ 3s

py 3.9

✕ build_error

236MB installed

● package 236MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

amalgam

✓ import amalgam

✗ from amalgam import Amalgam

Initialize the Amalgam runtime, load a model, and execute a command.

from amalgam import Amalgam # Initialize the library, providing path to amalgam shared library if needed # If the library is in standard locations, leave blank. amalgam = Amalgam() # Load an Amalgam model model = amalgam.load_model('path/to/model.amalgam') # Run a simple query result = model.execute("index") # or any Amalgam command print(result)

Debug

Known issues

breakingVersion 26+ changed the initialization signature. Amalgam() no longer accepts arguments like 'lib_path' directly; the shared library path must be set via environment variable 'AMALGAM_LIB_PATH' or the platform-specific default search.

fix

Set the environment variable 'AMALGAM_LIB_PATH' before creating Amalgam instance, or ensure the library is in a default search path.

affects: >=26.0.0

deprecatedThe method 'execute_query' is deprecated in favor of 'execute'. 'execute_query' may be removed in future versions.

fix

Use model.execute(...) instead of model.execute_query(...).

affects: >=28.0.0

gotchaAmalgam library requires a valid Amalgam shared library (.dll/.dylib/.so). The Python package does not include the native runtime by default. Missing library leads to a vague ImportError or RuntimeError.

fix

Download the appropriate Amalgam shared library from the official Amalgam releases and place it in a directory included in the system's library search path, or set AMALGAM_LIB_PATH.

affects: all

gotchaThread safety is not guaranteed. Running multiple Amalgam instances from different threads may cause crashes.

fix

Use thread-local instances or serialize access to a single Amalgam object.

affects: all

deprecatedPython 3.9 support was dropped in version 28.0.0.

fix

Use Python 3.10 or later.

affects: >=28.0.0

Upgrade

Version history

32.0.1latest on PyPI

Audit

Dependencies

amalgam-langrequiredCore package providing the Amalgam runtime interface.

Agent activity

107 hits · last 30 days

node

ahrefsbot

amazonbot

bytedance

Resources

githubhttps://github.com/howsoai/amalgam-lang-py ↗

packagehttps://pypi.org/project/amalgam-lang/ ↗

homepagehttps://howso.com ↗

docshttps://docs.howso.com/ ↗