Metadata-Version: 2.4
Name: teckel-ai
Version: 0.1.0
Summary: Simple SDK for AI trace tracking and RAG observability
Project-URL: Homepage, https://teckel.ai
Project-URL: Documentation, https://docs.teckel.ai
Project-URL: Repository, https://github.com/teckel-ai/teckel-python
Author-email: Teckel AI <support@teckel.ai>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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.10
Requires-Dist: httpx<1.0,>=0.25.0
Requires-Dist: pydantic<3.0,>=2.0
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: opentelemetry-api>=1.20.0; extra == 'dev'
Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'dev'
Requires-Dist: pytest-timeout>=2.2.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.22.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Provides-Extra: otel
Requires-Dist: opentelemetry-api>=1.20.0; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'otel'
Description-Content-Type: text/markdown

# teckel-ai (Python SDK)

Python SDK for [Teckel AI](https://teckel.ai) an agentic monitoring platform for tracking behavior and improving AI output.

## Install

```bash
pip install teckel-ai
```

## Minimal Usage

```python
from teckel import TeckelTracer

tracer = TeckelTracer(api_key="tk_live_...")
tracer.trace({"query": "Hello", "response": "Hi there"})
```

For serverless runtimes, call `tracer.flush(timeout_s=5.0)` before returning.

## Documentation

- Getting Started: https://docs.teckel.ai/docs/getting_started
- Python SDK Reference: https://docs.teckel.ai/docs/python_sdk_reference
- OpenTelemetry Integration: https://docs.teckel.ai/docs/opentelemetry_integration
- HTTP API Reference (canonical fields): https://docs.teckel.ai/docs/http_api_reference

## Requirements

- Python 3.10+
