# apache/burr

> burr is a Python library for building applications that make decisions, such as chatbots, agents and simulations. It lets you express an application as a state machine made of simple Python functions, so each step and transition is explicit. The core is written in Python and the project also ships a UI for tracing and monitoring execution.

Source: https://github.com/apache/burr
Indexed: commit d887c2f on 2026-07-22 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: Python
- Stars: 2,600 at index time
- License: Apache-2.0
- Code health: 7.7/10, Good
- Last commit: 2026-07-21
- Contributors: 56

## Install

From the README: https://github.com/apache/burr#quick-start

Clone the repository and go to the hello-world-counter example.
    git clone https://github.com/apache/burr && cd burr/examples/hello-world-counter

Run the counter example from its directory and watch its trace appear in the UI.
    python application.py

## How it works

Your application is written as a state machine, with the core logic in the burr package, and burr/core/action.py defines the actions that the state machine runs. Running the burr command starts the server defined in burr/cli/__main__.py, which opens the telemetry UI. burr/tracking/server/run.py is an entry point for the tracking server. The telemetry directory contains the UI code, and the tests directory holds the test suite. Runnable examples such as examples/hello-world-counter show how the pieces fit together.

- burr/cli/__main__.py: entry point
- burr/tracking/server/run.py: entry point
- burr/tracking/server/run.sh: entry point
- examples/custom-serde/run.py: entry point
- examples/deep-researcher/server.py: entry point
Modules: examples, burr, telemetry, tests, website, .github, docs, scripts. 513 files, 61,991 lines, 3,485 symbols.

## Code health

- Score: 7.7/10 (Good)
- Rank: #85 of 4,000+ indexed repos
- Hotspots: scripts/apache_release.py, burr/core/action.py, scripts/verify_apache_artifacts.py
- Lowest file: scripts/verify_apache_artifacts.py
- Dead code: 60 findings

## Maintenance

- Last commit 2026-07-21, first commit 2024-01-29, 945 commits
- 56 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/apache/burr/security

## More

- Page: https://repowise.dev/repo/apache/burr
- Ask this codebase: https://repowise.dev/repo/apache/burr/chat
- Docs: https://repowise.dev/repo/apache/burr/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/apache/burr
