Metadata-Version: 2.4
Name: sovara
Version: 0.3.3
Summary: Python SDK for Sovara agent observability and runtime instrumentation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: dill
Requires-Dist: flatten_dict
Requires-Dist: flatten_json
Requires-Dist: httpx
Requires-Dist: jsonpickle>=4.1.1
Requires-Dist: pydantic
Requires-Dist: pyyaml
Provides-Extra: examples
Requires-Dist: openai; extra == "examples"
Requires-Dist: anthropic; extra == "examples"
Requires-Dist: openai-agents; extra == "examples"
Requires-Dist: google-genai; extra == "examples"
Requires-Dist: claude-agent-sdk; extra == "examples"

# Sovara Python SDK

The `sovara` package instruments Python agents so Sovara can record LLM calls,
tool calls, logs, and custom trace spans.

Install it in the Python environment where your agent runs:

```bash
python -m pip install sovara
```

Or with `uv`:

```bash
uv add sovara
```

Use `sovara.run(...)` for library-mode recording:

```python
import sovara

with sovara.run("support-agent"):
    run_agent()
```

The terminal command is distributed separately as the native Sovara CLI. Install
that CLI for commands such as `sovara record`, `sovara status`, and
`sovara probe`.
