Metadata-Version: 2.4
Name: ratchet-core
Version: 0.1.0
Summary: The accountability layer for AI agents — core framework
Project-URL: Homepage, https://getratchet.dev
Project-URL: Repository, https://github.com/ratchet-framework/Ratchet
Project-URL: Issues, https://github.com/ratchet-framework/Ratchet/issues
Author: Aaron Benson
License-Expression: MIT
Keywords: agents,ai,autonomy,ratchet,self-improvement
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# ratchet-core

The kernel of the [Ratchet framework](https://getratchet.dev) — the accountability layer for AI agents.

`ratchet-core` provides:

- **Agent** — the runtime that manages module lifecycle, heartbeat loops, and sessions
- **RatchetModule** — the base class every module implements
- **EventBus** — async pub/sub for inter-module communication without tight coupling
- **Config** — context.json loading and validation
- **Channels** — abstract interface for communication (Telegram, Discord, CLI)
- **Stores** — abstract interface for state persistence (flat files, SQLite)

## Install

```bash
pip install ratchet-core
```

## Quick start

```python
from ratchet.core import Agent

agent = Agent(name="my-agent", config_path="config/context.json")
await agent.start()
```

## License

MIT
