Metadata-Version: 2.4
Name: litmus-trace
Version: 0.1.0
Summary: Record and deterministically replay AI agent executions
Project-URL: Homepage, https://github.com/romirjain/litmus
Project-URL: Repository, https://github.com/romirjain/litmus
Author: Romir Jain
License-Expression: MIT
Keywords: agents,ai,deterministic,llm,replay,testing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: starlette>=0.38
Requires-Dist: uvicorn>=0.30
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Description-Content-Type: text/markdown

# Litmus

Record and deterministically replay AI agent executions.

## Install

```bash
pip install litmus-trace
```

## Quick Start

```bash
# Start the recording proxy
litmus proxy --mode record

# In another terminal, point your SDK at the proxy and run your agent
ANTHROPIC_BASE_URL=http://localhost:8787/anthropic python my_agent.py

# View the recorded trace
litmus view ./traces/lt-*.trace.json

# Replay it deterministically
litmus replay ./traces/lt-*.trace.json
```

## Or use the Python SDK

```python
import litmus

litmus.init()  # starts proxy, patches env vars
# ... your agent code runs normally ...
litmus.shutdown()  # saves trace
```
