Metadata-Version: 2.4
Name: br8n
Version: 1.1.1
Summary: br8n — self-contained context-capture and resume engine.
Author-email: Anthony Suherli <anthonysuherli@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/anthonysuherli/br8n
Project-URL: Repository, https://github.com/anthonysuherli/br8n
Project-URL: Issues, https://github.com/anthonysuherli/br8n/issues
Keywords: claude-code,mcp,context,knowledge-base,developer-tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.122.0
Requires-Dist: uvicorn[standard]>=0.38.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-settings>=2.12.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: httpx>=0.28.1
Requires-Dist: langchain-core>=1.4.0
Requires-Dist: langchain-anthropic>=1.4.3
Requires-Dist: anthropic>=0.104.1
Requires-Dist: sqlite-vec>=0.1.6
Requires-Dist: supabase>=2.28.3
Requires-Dist: asyncpg>=0.31.0
Requires-Dist: pyjwt[crypto]>=2.10.1
Requires-Dist: argon2-cffi>=25.1.0
Requires-Dist: python-multipart>=0.0.20
Requires-Dist: openai>=2.30.0
Requires-Dist: tavily-python>=0.7.23
Requires-Dist: mcp>=1.16.0
Requires-Dist: jinja2>=3.1.4
Provides-Extra: dev
Requires-Dist: pytest>=8.4.2; extra == "dev"
Requires-Dist: pytest-asyncio>=1.3.0; extra == "dev"
Requires-Dist: httpx>=0.28.1; extra == "dev"
Requires-Dist: ruff<0.17,>=0.12.0; extra == "dev"
Requires-Dist: pyright>=1.1.409; extra == "dev"

# 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](https://github.com/anthonysuherli/br8n)
rather than by hand — the plugin bootstraps this package for you:

```
/plugin marketplace add anthonysuherli/br8n
/plugin install br8n@br8n
```

## Direct install

```bash
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. Binds `127.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:

```bash
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-vec` at `~/.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.
