Metadata-Version: 2.4
Name: agenttrace-lite
Version: 0.1.0
Summary: Lightweight, local-first observability SDK for AI agents
Author: Harsha Vardhan Tamada
License-Expression: MIT
Keywords: ai,agents,observability,tracing,llm,debugging
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# AgentTrace Lite

A lightweight, local-first observability SDK for AI agents. Track execution, nested spans, errors, and execution time with simple Python decorators or context managers.

## Features

- Sync and async function tracing
- Nested spans
- Error tracking
- Execution time measurement
- Custom span attributes
- JSONL trace export
- CLI for viewing and filtering traces

## Installation

```bash
pip install agenttrace-lite
```

## Quick Start

```python
from agenttrace_lite import Tracer

tracer = Tracer(service_name="my-ai-agent")

@tracer.trace
def run_agent():
    return "Hello, AI!"

run_agent()
tracer.flush()
```

## Context Manager

```python
with tracer.span("llm_call") as span:
    span.set_attribute("model", "gpt")
```

## View Traces

```bash
agenttrace traces
agenttrace traces --status error
agenttrace traces --name llm_call
```

## License

MIT
