Metadata-Version: 2.4
Name: nero-client
Version: 0.1.0
Summary: Lightweight Python client for the Nero voice-agent monitoring platform
Project-URL: Homepage, https://github.com/nurixlabs/nero
Project-URL: Documentation, https://docs.nero.dev
Author: Nero Team
License: MIT
Keywords: monitoring,nero,observability,voice-agent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# nero-client

Lightweight Python client for the [Nero](https://nero.dev) voice-agent monitoring platform.

## Installation

```bash
pip install nero-client
```

## Quick start

```python
from nero_client import NeroClient

nero = NeroClient(api_key="nero_...")

nero.end_session(
    transcript=[
        {"role": "assistant", "content": "Hi, this is Alex from ...", "timestamp": "2026-04-09T10:00:01Z"},
        {"role": "user", "content": "I'm not interested", "timestamp": "2026-04-09T10:00:04Z"},
    ],
    latency_metrics={"stt_ms": 180, "llm_ms": 620, "tts_ms": 240, "round_trip_ms": 1040},
    tool_calls=[{"name": "lookup_customer", "params": {"phone": "+1234567890"}, "result": {"name": "Jane"}}],
    metadata={"caller_id": "+1234567890", "campaign": "q2_upsell", "duration_ms": 45000},
)
```

### Async

```python
await nero.end_session_async(transcript=[...])
```

### Configuration

| Parameter | Env var | Default |
|-----------|---------|---------|
| `api_key` | `NERO_API_KEY` | _(required)_ |
| `base_url` | `NERO_BASE_URL` | `https://api.nero.dev` |
| `timeout` | — | `10.0` |
| `max_retries` | — | `3` |

## License

MIT
