Metadata-Version: 2.4
Name: agenttrace-io
Version: 0.4.12
Summary: AgentTrace Python SDK - Drop-in tracing for any AI agent
Author: Klepsiphron
License: MIT
Project-URL: Homepage, https://github.com/Klepsiphron/agenttrace
Project-URL: Repository, https://github.com/Klepsiphron/agenttrace
Keywords: ai,agents,observability,tracing,llm
Classifier: Development Status :: 4 - Beta
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 :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"

# agenttrace-io (Python SDK)

Drop-in tracing for any AI agent. Local SQLite storage, zero dependencies, zero cloud.

## Installation

```bash
pip install agenttrace-io
```

Requires Python 3.10+.

## Quickstart

```python
from agenttrace import init, trace

agent = init(db_path="./traces.db")

# Trace a callable
result = agent.trace("my-op", lambda: 42 * 2)

# Use as decorator
@trace("greet")
def greet(name: str) -> str:
    return f"Hello, {name}"

# Use as context manager
with agent.trace("context-op") as t:
    value = "computed"
    t.set_output(value)

# Query and export
traces = agent.get_traces()
stats = agent.get_stats()
agent.export("json")
agent.close()
```

See the [full README](https://github.com/Klepsiphron/agenttrace#python-sdk) for more.

## License

MIT © Klepsiphron
