Metadata-Version: 2.4
Name: sovara
Version: 0.8.0
Summary: Python SDK for Sovara agent observability and runtime instrumentation
Project-URL: Documentation, https://docs.sovara-labs.com
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: filelock
Requires-Dist: flatten_dict
Requires-Dist: flatten_json
Requires-Dist: httpx
Requires-Dist: jsonpickle>=4.1.1
Requires-Dist: pydantic
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

Record supported LLM, MCP and tool calls, logs and custom spans.

```bash
uv add sovara
```

```python
from sovara import SovaraClient

client = SovaraClient(project_name="My Project")
with client.trace("support-agent", trace_id="conversation-123"):
    with client.turn(turn_input="Hello"):
        run_agent()
```

`trace_id` accepts a stable user identifier or a canonical `sovara-` ID. The trace
context returns the canonical ID. `turn()` declares a logical interaction;
work outside a turn remains recorded with null turn membership. Use `subtrace()`
for child work and `@trace` for custom functions.

The SDK requires runner-api 5. Install the current native CLI for local
exec-server startup. Remote clients pass `base_url` and `agent_token`;
`http_client` accepts a caller-owned synchronous `httpx.Client`.

[Quickstart](https://docs.sovara-labs.com/sdks/python/quickstart) ·
[Usage](https://docs.sovara-labs.com/sdks/python/use-the-sdk) ·
[API](https://docs.sovara-labs.com/sdks/python/api-reference) ·
[Provider compatibility](COMPATIBILITY.md) ·
[Release policy](../README.md#release-surfaces)
