Metadata-Version: 2.4
Name: agents-brain
Version: 0.0.1
Summary: Context, memory, documentation RAG and observability umbrella for autonomous coding agents
Author: Lolaplex
License-Expression: MIT
Project-URL: Homepage, https://lolaplex.org
Project-URL: Repository, https://github.com/Lolaplex/agents-brain
Project-URL: Documentation, https://lolaplex.org
Keywords: agents,coding-assistant,mcp,memory,traces,docs,rag,ai,context
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agents-memory>=1.2.0
Requires-Dist: agents-docs>=0.45.0
Requires-Dist: agents-traces>=0.1.0
Provides-Extra: browser
Requires-Dist: agents-browser>=0.45.0; extra == "browser"
Provides-Extra: all
Requires-Dist: agents-memory>=1.2.0; extra == "all"
Requires-Dist: agents-docs>=0.45.0; extra == "all"
Requires-Dist: agents-traces>=0.1.0; extra == "all"
Requires-Dist: agents-browser>=0.45.0; extra == "all"
Dynamic: license-file

# agents-brain

Unified context, memory, documentation RAG, and observability engine for autonomous coding agents.

Part of the [Lolaplex](https://lolaplex.org) agent suite.

## What is `agents-brain`?

`agents-brain` orchestrates the cognitive layer of your coding assistant setup:

- **Long-term local memory (`agents-memory`)**: Project registries, durable user facts, staging inboxes, distillation workflows.
- **Durable technical documentation RAG (`agents-docs`)**: Ultra-fast local BM25 indexing for APIs, stacks, and platform playbooks.
- **Trace observability & diagnostics (`agents-traces`)**: High-throughput JSONL telemetry, self-healing, tamper seals, and error tracking.
- *(Optional)* **Zero-Node CDP browser (`agents-browser`)**: Direct DevTools automation for live web verification and scraping.

## Installation

```bash
# Core brain stack (memory + docs + traces)
pip install agents-brain

# Full brain stack including CDP browser automation
pip install "agents-brain[all]"
```

## Quick Start & CLI

Inspect local environment, stores, and installed brain components:

```bash
agents-brain status
agents-brain doctor
```

JSON output for tool integration:

```bash
agents-brain status --json
agents-brain --help-json
```

## License

MIT © Lolaplex
