Metadata-Version: 2.5
Name: fairway-kit
Version: 0.4.0
Summary: Dev kit backend for local agent-backed apps: durable, resumable agent chat over FastAPI (SQLite, Postgres, or MySQL)
Project-URL: Homepage, https://github.com/datagoboom/fairway-kit
Project-URL: Repository, https://github.com/datagoboom/fairway-kit
Author: Andrew Long
License-Expression: MIT
Keywords: agent,chat,claude,fastapi,llm,local-first,sse,streaming
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: aiosqlite>=0.20
Requires-Dist: fastapi>=0.115
Requires-Dist: python-multipart>=0.0.9
Provides-Extra: claude
Requires-Dist: claude-agent-sdk>=0.2; extra == 'claude'
Provides-Extra: mysql
Requires-Dist: aiomysql>=0.2; extra == 'mysql'
Requires-Dist: cryptography>=41; extra == 'mysql'
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.29; extra == 'postgres'
Description-Content-Type: text/markdown

# fairway (backend)

The Python half of [fairway](https://github.com/datagoboom/fairway-kit), a dev
kit for building local, agent-backed applications with durable, resumable chat.

```python
from fastapi import FastAPI
from fairway import mount_agent_chat
from fairway.adapters.claude_sdk import ClaudeSDKRunner

app = FastAPI()
store, registry = mount_agent_chat(
    app,
    db_path="./chat.db",
    runner=ClaudeSDKRunner(model="claude-opus-4-8", auth="subscription"),
)
```

One call mounts the full HTTP surface: sessions, send, SSE streaming with
seq-cursor replay, active-job reattach, inline tool approval, server-owned
stop, and restart-safe job recovery. Any agent can drive it, since a runner is
just an async callable that emits protocol events.

Pairs with the `fairway-kit` npm package on the frontend. Full docs and a
complete example app live in the
[repository](https://github.com/datagoboom/fairway-kit).
