---
id: amalgam-lang
version: "34.2.6"
license: GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this… (full text in the JSON record)
license_treatment: agpl
maintenance: active
---

# amalgam-lang — A direct interface with Amalgam compiled DLL, dylib, or so.

License: agpl · Maintenance: active · Downloads: 85.3K/mo

## What it is and what it does

Amalgam is a Python interface to Amalgam, a specialized language built for safe, sandboxed execution and code generation. Unlike general-purpose languages, Amalgam prioritizes code-data symmetry and semantic consistency, making it suited for domains like genetic programming, instance-based machine learning, simulation, and agent-based modeling. The wrapper handles the underlying compiled binary automatically, so you load Amalgam entity files (.amlg or .caml) and execute labeled functions by passing JSON parameters and receiving JSON results.

The package ships with precompiled binaries for Windows (x86_64), Linux (x86_64 and arm64), and macOS (arm64). It has no runtime Python dependencies, making installation straightforward. You write Amalgam code natively or through this Python wrapper, and the language's design emphasizes information-theoretic properties and safe execution semantics rather than developer convenience.

Use it for:

- Genetic programming: evolve code or data structures in a sandboxed, semantically consistent environment.
- Instance-based machine learning: implement algorithms that learn from individual examples using Amalgam's data-code symmetry.
- Agent-based modeling: define and execute agent behaviors and interactions with guaranteed semantic safety.
- Simulation: build deterministic, reproducible simulations where code and data are interchangeable.
- Game AI and content generation: generate game logic and AI behaviors using Amalgam's information-theoretic inference.
- Data storage and retrieval: leverage Amalgam's tree structure for efficient, semantically consistent data operations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Amalgam is a Python wrapper that lets you call Amalgam, a tree-structured language designed for safe, sandboxed code generation and information-theoretic inference, directly from Python code.

Yes, if you need safe, sandboxed code generation or are exploring genetic programming, instance-based learning, or agent-based modeling. The package is actively maintained, has no external dependencies, and is marked production-stable. However, verify that your OS and CPU architecture are in the supported set (Windows/Linux x86_64, Linux/macOS arm64), and be aware that the GNU Affero v3 license requires source disclosure if you deploy it as a network service. For private or non-network use, it poses no licensing friction.

## Install

pip install amalgam-lang
uv add amalgam-lang
poetry add amalgam-lang

## Installing amalgam-lang

Before you install: Installs with no runtime dependencies and has been actively maintained with a release within the past week. The package is marked production-stable and supports current Python versions (3.11–3.14).

License in practice: Licensed under GNU Affero General Public License v3, which requires that if you modify and run the package as a network service, you must make your modified source code available to users. For private use or non-network deployment, this is less restrictive.

Quickstart:

pip install amalgam-lang

from amalgam.api import Amalgam
import json

amlg = Amalgam()
amlg.load_entity("handle_name", "/path/to/file.amlg")
response = amlg.execute_entity_json("handle_name", "label_name", json.dumps({"abc": 123}))
result = json.loads(response)

Requires Python 3.11 or later. The package bundles platform-specific binaries (Windows x86_64, Linux x86_64 and arm64, macOS arm64); verify your OS and architecture are supported before installing.

Verify before relying:

- Whether the bundled Amalgam binary can be overridden reliably across all supported platforms and architectures.
- Performance characteristics and scalability limits for typical workloads (genetic programming, simulation, agent-based modeling).
- Maturity and stability of the Amalgam language itself beyond the wrapper's production-stable classification.

## Package facts

- License: GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this… (full text in the JSON record) (agpl)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tree-structured language wrapper, sandboxed code generation, LLM-ready language interface, genetic programming framework, instance-based machine learning, information theory computation, safe code execution, agent-based modeling, sandboxed-execution, genetic-programming, agent-modeling

[View on SkillFed](https://skillfed.io/packages/amalgam-lang) · [View on PyPI](https://pypi.org/project/amalgam-lang/)