Metadata-Version: 2.4
Name: rundb-ai
Version: 0.1.0
Summary: Local-first, single-file database for AI agents: runs, retries, traces, memory. SDK + CLI + MCP server.
Author: Ashish Sharda
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/ashishjsharda/rundb
Project-URL: Issues, https://github.com/ashishjsharda/rundb/issues
Keywords: ai-agents,agents,mcp,sqlite,tracing,memory,llm,observability
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Dynamic: license-file

# rundb (Python)

Python SDK, CLI and MCP server for [RunDB](https://github.com/ashishjsharda/rundb): a local-first, single-file database for AI agent runs, retries, traces and memory. It depends only on the standard library.

```bash
pip install rundb-ai        # installs the `rundb` package and the `rundb` CLI
```

```python
from rundb import connect

db = connect("agent.db")
run = db.start_run("my-repo", goal="make tests pass")
db.log_span(run, "tool", "pytest", error="ModuleNotFoundError: requests")
retry = db.fork_run(run, goal="install deps first")
db.remember("my-repo", "tests.setup", "pip install -r requirements.txt first", kind="constraint")
db.end_run(retry, "succeeded")
print(db.what_failed("my-repo")["suggested_next_step"])
```

MCP server: `rundb mcp` (stdio). The full docs are in the [main README](https://github.com/ashishjsharda/rundb#readme).
