Metadata-Version: 2.4
Name: tvisha
Version: 0.1.0
Summary: Tvisha observability SDK — one-line tracing for LLM applications
License-Expression: Apache-2.0
Requires-Python: >=3.9
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.20.0
Requires-Dist: opentelemetry-sdk>=1.20.0
Provides-Extra: langchain
Requires-Dist: opentelemetry-instrumentation-langchain>=0.30.0; extra == 'langchain'
Description-Content-Type: text/markdown

# tvisha

One-line observability for LLM applications. Traces LangChain, LangGraph, and any OpenTelemetry-instrumented code and sends data to the Tvisha platform.

## Installation

```bash
pip install tvisha

# With automatic LangChain/LangGraph instrumentation:
pip install tvisha[langchain]
```

## Quick start

```python
import tvisha

tvisha.init(
    project_name="my-agent",
    api_key="tvisha_live_myproj_abc123...",
    otlp_endpoint="https://traces.tvisha.io",
)

# All LangChain / LangGraph calls are now traced automatically.
```

## Configuration

| Parameter | Env var fallback | Default |
|---|---|---|
| `project_name` | — | *(required)* |
| `api_key` | `TVISHA_API_KEY` | `None` (no auth header) |
| `otlp_endpoint` | `TVISHA_ENDPOINT` | `http://localhost:8082` |

Arguments passed to `init()` take precedence over environment variables.

## Environment-variable-only setup

```bash
export TVISHA_API_KEY="tvisha_live_myproj_abc123..."
export TVISHA_ENDPOINT="https://traces.tvisha.io"
```

```python
import tvisha
tvisha.init(project_name="my-agent")
```
