Python OTEL SDK (Recommended)
HoneyHive provides a full-featured Python SDK built on OpenTelemetry for comprehensive tracing, observability, and evals.Python SDK - Reference Docs
Complete API reference documentation
Python SDK - GitHub
Source code and examples
Key Features
- OpenTelemetry-based - Follows GenAI semantic conventions and W3C Trace Context with automatic context propagation. Learn more
- Auto-instrumentation - Automatically trace major model providers and agent frameworks using OpenTelemetry instrumentors
- Custom instrumentation - Built-in utilities like
@trace,enrich_span(), and context managers for manual tracing - BYOI architecture - Install only the instrumentors you need without dependency conflicts or version lock-in. Learn more
- Multi-instance support - Run isolated tracer instances for multi-tenant apps or environment-based routing. Learn more
TypeScript SDK
The@honeyhive/api-client package gives you a type-safe TypeScript client for the HoneyHive REST API. Browse the generated API docs for the full client surface.
TypeScript API docs
Full generated reference for
@honeyhive/api-clientOpenAPI SDKs (Any Language)
HoneyHive publishes a public OpenAPI specification that fully describes our REST API. Every team can use their preferred open-source SDK generator to deploy a lightweight SDK in their respective language on top of our public OpenAPI spec.OpenAPI SDKs
Generate type-safe SDKs in any language
OpenAPI Spec (GitHub)
Browse the full OpenAPI specification
When to Use OpenAPI SDKs
Generated OpenAPI SDKs have no external dependencies beyond your language’s standard HTTP libraries, making them ideal for:- Any language - Go, Java, Ruby, Rust, C#, PHP, or any language with an OpenAPI generator
- Serverless environments - AWS Lambda, Google Cloud Functions, Azure Functions where package size matters
- Regulated environments - Industries with strict security requirements where adding dependencies is difficult
- Full control - Customize the generated code, extend it, or integrate it directly into your existing codebase
Quick Comparison
| Feature | Python OTEL SDK | TypeScript SDK | OpenAPI SDKs (Generated) |
|---|---|---|---|
| Dependencies | OpenTelemetry + provider SDKs | openapi-fetch + axios | Zero external dependencies |
| Auto-instrumentation | Yes (via BYOI) | No - manual API calls | No - manual API calls |
| Custom instrumentation | @trace, enrich_span, enrich_session | Type-safe REST methods | Type-safe generated client |
| Context propagation | Automatic | Manual | Manual |
| Language | Python | TypeScript / Node.js | Any language with an OpenAPI generator |
| Setup effort | Low - auto-traces LLM calls | Low - install and use | Low - generate and use |
| Use case | Most Python applications | TypeScript / Node.js applications | Other languages, serverless, regulated environments |
Getting Started
Quick Start Guide
Add tracing to your app in 5 minutes
Integrations
Browse framework and provider integrations