Metadata-Version: 2.4
Name: retrace-sdk
Version: 0.1.3
Summary: Record, replay, fork & share AI agent executions
Project-URL: Homepage, https://retrace.yashbogam.me
Project-URL: Repository, https://github.com/yash1511-bogam/retrace
Author: Yash Bogam
License: MIT
Requires-Python: >=3.10
Requires-Dist: requests>=2.32.0
Requires-Dist: websocket-client>=1.9.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: gemini
Requires-Dist: google-genai>=1.52.0; extra == 'gemini'
Description-Content-Type: text/markdown

# retrace-sdk

The execution replay engine for AI agents. Record every LLM call, tool invocation, and error your AI agent makes. Replay step-by-step. Fork from any point. Share interactive traces via URL.

## Install

```bash
pip install retrace-sdk
```

## Quick Start

```python
from retrace_sdk import configure, record

configure(api_key="rt_live_...")

@record(name="my-agent")
def run_agent(prompt: str):
    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[{"role": "user", "content": prompt}]
    )
    return response.choices[0].message.content

run_agent("What is quantum computing?")
```

## Features

- **Record** — One decorator captures every LLM call, tool call, and error
- **Replay** — Step through executions with play/pause/speed controls
- **Fork** — Branch from any step, modify input, watch a new path diverge
- **Share** — Publish traces as shareable "tapes" with interactive playback

## Links

- [Documentation](https://retrace.yashbogam.me/docs)
- [GitHub](https://github.com/yash1511-bogam/retrace)
