Core OTEL SDKs (Recommended)
HoneyHive provides full-featured SDKs built on OpenTelemetry for comprehensive tracing, observability, and evals.Python SDK - Reference Docs
Complete API reference documentation
Python SDK - GitHub
Source code and examples
TypeScript SDK is coming soon. If you’re interested in early access, please reach out to us.
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
OpenAPI 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 | Core OTEL SDKs | OpenAPI SDKs (Generated) |
|---|---|---|
| Dependencies | OpenTelemetry + provider SDKs | Zero external dependencies |
| Auto-instrumentation | Yes (via BYOI) | No - manual API calls |
| Custom instrumentation | Built-in utilities (@trace, enrich_span, enrich_session) | Type-safe generated client |
| Context propagation | Automatic | Manual |
| Language support | Python (TypeScript coming soon) | Any language with an OpenAPI generator |
| Setup effort | Low - auto-traces LLM calls | Low - generate and use |
| Use case | Most Python applications | Any language, serverless, regulated environments |