---
id: baml-py
version: "0.225.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# baml-py — BAML v0 — Python runtime for baml_client

License: unclear · Maintenance: active · Downloads: 489.9K/mo

## What it is and what it does

baml-py is the Python runtime component for BAML, a language designed specifically for building agents with a strong type system. It allows you to execute BAML code from Python, bridging the gap between BAML's compile-time safety guarantees and Python's runtime ecosystem. The package is a binary distribution with no runtime dependencies that executes pre-compiled BAML code.

BAML emphasizes preventing agent mistakes through typed errors, static analysis, and a built-in standard library for agents. The language supports green threads and colorless concurrency. baml-py enables incremental adoption—you can call BAML functions from Python alongside existing code, or integrate it into larger systems that also use other languages.

Use it for:

- Build Python-based agents with compile-time type safety and error handling
- Incrementally adopt BAML in existing Python projects by calling BAML functions
- Implement agent logic with built-in testing and evaluation frameworks
- Create multi-language agent systems where Python calls BAML functions

## Worth the install?

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

baml-py is the Python runtime for executing BAML programs, a language designed for building agents with strong typing and error handling.

Yes, if you are building agents in Python and want the type safety that BAML provides. The package is actively maintained, has no known vulnerabilities, and installs cleanly across major platforms. However, verify the license terms first (currently unclear) and confirm that BAML's compilation tooling fits your workflow—baml-py is the runtime only.

## Install

pip install baml-py
uv add baml-py
poetry add baml-py

## Installing baml-py

Before you install: Medium install friction due to platform-specific binary wheels across macOS, Linux, and Windows architectures. Active maintenance with recent releases and a well-maintained repository (9006 stars, last commit 2026-08-14).

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before adopting in commercial or restricted-license projects.

Quickstart:

pip install baml-py

import baml_py
# Call BAML functions from your compiled BAML project

Requires Python 3.10 or later. BAML programs must be compiled and available in your project; baml-py is the runtime component only.

Verify before relying:

- How baml-py integrates with the BAML compiler and project structure in practice
- Whether baml-py can be used standalone or requires external BAML tooling installation
- Performance characteristics and typical use patterns for agent workloads
- What the actual license terms are for this package

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 489.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

baml python runtime, agent programming language, typed agent framework, baml python client, agent type system python, agent-framework, type-safety

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