Metadata-Version: 2.4
Name: korveo
Version: 1.0.5
Summary: Local-first AI agent observability SDK
Author: Zistica Inc.
License: Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Requires-Dist: simpleeval>=0.9.13
Requires-Dist: pyyaml>=6.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21; extra == "test"
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.3.0; extra == "langchain"
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.2.0; extra == "langgraph"
Provides-Extra: crewai
Requires-Dist: crewai>=0.80.0; extra == "crewai"
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.30.0; extra == "anthropic"
Provides-Extra: llama-index
Requires-Dist: llama-index-core>=0.10.0; extra == "llama-index"
Provides-Extra: litellm
Requires-Dist: litellm>=1.40.0; extra == "litellm"
Provides-Extra: openai-agents
Requires-Dist: openai-agents>=0.0.1; extra == "openai-agents"
Provides-Extra: autogen
Requires-Dist: pyautogen>=0.4.0; extra == "autogen"
Provides-Extra: pydantic-ai
Requires-Dist: pydantic-ai>=0.0.13; extra == "pydantic-ai"
Provides-Extra: all
Requires-Dist: langchain-core>=0.3.0; extra == "all"
Requires-Dist: langgraph>=0.2.0; extra == "all"
Requires-Dist: crewai>=0.80.0; extra == "all"
Requires-Dist: anthropic>=0.30.0; extra == "all"
Requires-Dist: llama-index-core>=0.10.0; extra == "all"
Requires-Dist: litellm>=1.40.0; extra == "all"
Requires-Dist: openai-agents>=0.0.1; extra == "all"
Requires-Dist: pyautogen>=0.4.0; extra == "all"
Requires-Dist: pydantic-ai>=0.0.13; extra == "all"

# korveo (Python SDK)

Local-first AI agent observability. 2 lines of code.

```python
import korveo

korveo.configure(host="http://localhost:8000")

@korveo.trace
def my_agent(input: str) -> str:
    return "hello"

my_agent("test")
```

Spans are captured asynchronously. If the Korveo server is unreachable,
the agent continues working — spans are dropped silently.

## Install

```bash
pip install -e packages/sdk-python/
```

## Configuration

Configuration priority: explicit `configure(...)` > environment variable > default.

| Option | Env var | Default |
|---|---|---|
| `host` | `KORVEO_HOST` | `http://localhost:8000` |
| `api_key` | `KORVEO_API_KEY` | `None` |
| `project` | `KORVEO_PROJECT` | `default` |
| `capture_inputs` | — | `True` |
| `capture_outputs` | — | `True` |
| `max_payload_size` | — | `10240` |
| `batch_size` | — | `100` |
| `flush_interval` | — | `2.0` |
| `max_queue_size` | — | `10000` |
| `export_timeout` | — | `5.0` |
