br8n — self-contained context-capture and resume engine.
Project description
br8n
Context-capture and resume engine — captures developer intent on interruption and replays it as a resume card, so picking work back up costs seconds instead of minutes.
This package is the br8n backend: the FastAPI service, the MCP server that Claude Code talks to, and the local/cloud storage tiers behind them.
Most people should install br8n as a Claude Code plugin rather than by hand — the plugin bootstraps this package for you:
/plugin marketplace add anthonysuherli/br8n
/plugin install br8n@br8n
Direct install
pip install br8n
Two entry points are installed:
br8n-mcp— the MCP server (stdio), for wiring into an MCP client by hand.br8n-server— the local HTTP API. Binds127.0.0.1:8002; on the local tier it refuses any non-loopback host, because that tier runs without API auth.
Check the install with:
python -m br8n.api.main --check
Tiers
br8n ships one engine with two storage backends, selected by BR8N_BACKEND:
- local (default when no Supabase credentials are present) — SQLite +
sqlite-vecat~/.br8n/brain.db, single user, loopback only, no auth. - cloud — Supabase (pgvector + GoTrue), multi-user, per-request JWT tenancy.
Capture and resume work with no API keys at all. Semantic search needs an
embedding key (AI_GATEWAY_API_KEY or OPENAI_API_KEY); the explore/gap-fill
pipeline additionally needs TAVILY_API_KEY. See .env.example in the repository
for the full matrix.
Source, issues, and documentation: https://github.com/anthonysuherli/br8n
MIT licensed.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file br8n-1.1.1.tar.gz.
File metadata
- Download URL: br8n-1.1.1.tar.gz
- Upload date:
- Size: 162.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b5b1e8d7f5ee7f16217fec13613aeb4bc57a79bbdae817e37f89ed0a931bb95
|
|
| MD5 |
93538674b69013be5d20d863268eb7d5
|
|
| BLAKE2b-256 |
9f6500a573633f0f2c271444988190940fc44453c08e0fde644f095f867fdb27
|
File details
Details for the file br8n-1.1.1-py3-none-any.whl.
File metadata
- Download URL: br8n-1.1.1-py3-none-any.whl
- Upload date:
- Size: 152.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8ea02c484ab6e6f9bacc64eec024c5e15d4c30b438544eed02b19f9e61d7c7a4
|
|
| MD5 |
3723c693d95081d0f50ff6c3bb88ea99
|
|
| BLAKE2b-256 |
0e4bf58bc063defc4f065da94dec72976b406e562c4577fc74f54aa227d52b65
|
