{"id":23242,"library":"amalgam-lang","title":"Amalgam Language Python Bindings","description":"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.","status":"active","version":"29.0.1","language":"python","source_language":"en","source_url":"https://github.com/Amalgam-Language/amalgam-lang","tags":["amalgam","language-bindings","native","shared-library","python-interface"],"install":[{"cmd":"pip install amalgam-lang==29.0.1","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core package providing the Amalgam runtime interface.","package":"amalgam-lang","optional":false}],"imports":[{"wrong":"from amalgam import Amalgam","symbol":"amalgam","correct":"import amalgam"}],"quickstart":{"code":"from amalgam import Amalgam\n\n# Initialize the library, providing path to amalgam shared library if needed\n# If the library is in standard locations, leave blank.\namalgam = Amalgam()\n\n# Load an Amalgam model\nmodel = amalgam.load_model('path/to/model.amalgam')\n\n# Run a simple query\nresult = model.execute(\"index\")  # or any Amalgam command\nprint(result)","lang":"python","description":"Initialize the Amalgam runtime, load a model, and execute a command."},"warnings":[{"fix":"Set the environment variable 'AMALGAM_LIB_PATH' before creating Amalgam instance, or ensure the library is in a default search path.","message":"Version 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.","severity":"breaking","affected_versions":">=26.0.0"},{"fix":"Use model.execute(...) instead of model.execute_query(...).","message":"The method 'execute_query' is deprecated in favor of 'execute'. 'execute_query' may be removed in future versions.","severity":"deprecated","affected_versions":">=28.0.0"},{"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.","message":"Amalgam 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use thread-local instances or serialize access to a single Amalgam object.","message":"Thread safety is not guaranteed. Running multiple Amalgam instances from different threads may cause crashes.","severity":"gotcha","affected_versions":"all"},{"fix":"Use Python 3.10 or later.","message":"Python 3.9 support was dropped in version 28.0.0.","severity":"deprecated","affected_versions":">=28.0.0"}],"env_vars":null,"search_vec":"'29.0.1':26 '3.10':29 'activ':33 'amalgam':1,9,19,38 'bind':4,6,41 'compil':18 'direct':14 'dll':22 'dylib':23 'frequent':36 'interfac':15,48 'languag':2,10,40 'language-bind':39 'librari':21,31,45 'maintain':34 'nativ':42 'provid':12 'python':3,5,28,47 'python-interfac':46 'releas':37 'runtim':11 'share':20,44 'shared-librari':43 'support':27 'version':25","created_at":"2026-05-01T08:06:43.491671+00:00","updated_at":"2026-05-01T08:06:43.491671+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"32.0.1","cli_name":"","cli_version":null,"type":"library","homepage":"https://howso.com","github":"https://github.com/howsoai/amalgam-lang-py","docs":"https://docs.howso.com/","changelog":null,"pypi":"https://pypi.org/project/amalgam-lang/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}