# Apache Burr

> Apache Burr (Incubating) is an open-source Python framework for building reliable, stateful AI applications and agents using a simple state machine model.

Apache Burr (Incubating) is a pure-Python, open-source framework for building applications that make decisions — from simple chatbots to complex multi-agent systems. It is currently undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. The project is released under the Apache License 2.0 and is freely available on GitHub.

## What It Is

Apache Burr is a state machine framework for AI and LLM-powered applications. Developers express their application as a graph of actions and transitions using plain Python functions and decorators — no DSL, no YAML, no proprietary abstractions. The core library is dependency-free and designed to integrate with any LLM provider or Python framework. Burr also ships a built-in UI for real-time monitoring, tracing, and debugging of application state.

## How the State Machine Model Works

Every Burr application is built around the `ApplicationBuilder` API. Developers annotate Python functions with `@action(reads=[...], writes=[...])` to declare which parts of state each step reads and modifies. Transitions between actions are declared explicitly, making the control flow of even complex multi-agent systems easy to follow and test. The framework supports:

- Sequential and branching workflows
- Parallel fan-out / fan-in execution
- Sub-application composition for modular design
- Human-in-the-loop pauses at any step
- Automatic state persistence to disk, databases, or custom backends

## Built-in Observability and Debugging

Burr includes a local telemetry UI that launches with a single `burr` CLI command. The UI displays real-time state changes, execution traces, and historical run data. Developers can replay past runs, unit test individual actions, and build evaluation cases from captured state snapshots — capabilities that the GitHub README highlights as differentiators versus frameworks like LangGraph, LangChain, and Temporal.

## Integrations and Stack Compatibility

Burr is designed to be framework-agnostic. The homepage lists integrations with:

- **LLM providers**: OpenAI, Anthropic, Instructor
- **Frameworks**: LangChain, Apache Hamilton, Haystack
- **Serving**: FastAPI
- **UI**: Streamlit
- **Validation**: Pydantic
- **Storage**: PostgreSQL

Because Burr does not wrap or abstract these tools, developers retain full control over how they query APIs, manage data, and structure models.

## Update: v0.42.0-incubating

The latest release as of May 2026 is v0.42.0-incubating, published on May 10, 2026. The GitHub repository shows active development with the last push in June 2026. The project roadmap (listed in the README) includes planned FastAPI integration for hosted deployment, first-class retry and exception management, additional storage integrations (MySQL, S3), and tooling for hosted execution on infrastructure like Ray and Modal. A Burr Cloud offering was mentioned on the roadmap with a waitlist signup, though no further details are available in the current sources.

## Why It Got Attention

Burr originated as a harness for managing state between executions of Apache Hamilton DAGs — since DAGs lack cycles, Burr was built to handle the stateful, looping nature of agent workflows. It was subsequently released as a standalone framework. The GitHub README includes a comparison table showing Burr as one of the few frameworks that explicitly models a state machine, provides an open-source monitoring UI, and works with non-LLM use cases such as time-series simulations and hyperparameter tuning. The repository has accumulated over 2,300 GitHub stars and more than 242,000 PyPI downloads according to the project homepage.

## Features
- State machine-based application model
- Pure Python API with no DSL or YAML
- Built-in telemetry and monitoring UI
- Automatic state persistence to disk, databases, or custom backends
- Human-in-the-loop support for approval workflows
- Parallel execution with fan-out/fan-in
- Sub-application composition for modular design
- Run replay and unit testing of individual actions
- Framework-agnostic LLM integration
- CLI launcher for local UI server
- Pluggable persisters for memory and state management
- Real-time state change visualization

## Integrations
OpenAI, Anthropic, LangChain, Apache Hamilton, Streamlit, FastAPI, Haystack, Instructor, Pydantic, PostgreSQL

## Platforms
CLI, WEB, API

## Pricing
Open Source

## Version
v0.42.0-incubating

## Links
- Website: https://burr.apache.org
- Documentation: https://burr.apache.org/docs
- Repository: https://github.com/apache/burr
- EveryDev.ai: https://www.everydev.ai/tools/apache-burr