Metadata-Version: 2.4
Name: tidal-telemetry
Version: 0.1.0
Summary: One-line LLM observability for Tidal Telemetry - auto-instruments 50+ AI libraries and streams OpenTelemetry traces to your Tidal project.
Author: Tidal Telemetry
License: Apache-2.0
Project-URL: Homepage, https://openlit.llmcfo.com
Project-URL: Documentation, https://openlit.llmcfo.com/tenant-onboarding/skill.md
Keywords: llm,observability,opentelemetry,tracing,openai,anthropic,langchain,genai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: openlit<2.0,>=1.43.0

# tidal-telemetry

One-line LLM observability. Auto-instruments 50+ AI libraries (OpenAI,
Anthropic, LangChain, LlamaIndex, Ollama, vector DBs, agent frameworks, ...)
and streams OpenTelemetry traces - latency, tokens, cost, prompts - to your
Tidal Telemetry project.

## Install

```bash
pip install tidal-telemetry
```

## Use

```python
import tidal_telemetry as tidal

tidal.init()  # reads TIDAL_API_KEY + TIDAL_PROJECT from the environment
```

```bash
export TIDAL_API_KEY="<your project token>"
export TIDAL_PROJECT="<org-project>"
python your_app.py
```

Or configure in code:

```python
tidal.init(api_key="tt_...", project="acme-production", application_name="checkout-bot")
```

Trace your own functions too:

```python
@tidal.trace
def handle_request(prompt):
    ...
```

Your API key and project slug are on the project's onboarding page:
`https://openlit.llmcfo.com` → Settings → Organisation → Projects.

## Environment variables

| Variable | Meaning |
|---|---|
| `TIDAL_API_KEY` | Project token (required unless passed to `init`) |
| `TIDAL_PROJECT` | Project slug, e.g. `acme-production` |
| `TIDAL_ENDPOINT` | Ingest base URL override (defaults to the hosted endpoint) |
| `OTEL_SERVICE_NAME` | Service name shown in dashboards |

Built on the [OpenLIT](https://github.com/openlit/openlit) SDK (Apache-2.0);
every `openlit.init` keyword argument passes through unchanged.
