Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.honeyhive.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 API SDK

The @honeyhive/api-client package gives you a type-safe TypeScript client for the HoneyHive REST API. Browse the generated reference for the full client surface.

TypeScript API SDK - Reference

Full generated reference for @honeyhive/api-client

HoneyHive CLI

The HoneyHive CLI lets you work with HoneyHive from your terminal. Use it for scripting, automation, CI workflows, and AI coding agents like Cursor and Claude Code.

CLI Docs

Find installation steps and generated command reference links

Use with Coding Agents

Combine the CLI with HoneyHive Skills and Docs MCP

OpenAPI Client (Any Language)

HoneyHive publishes a public OpenAPI specification that fully describes our REST API. Every team can use their preferred open-source client generator to produce a lightweight client in their respective language on top of our public OpenAPI spec.

OpenAPI Client

Generate type-safe clients in any language

OpenAPI Spec (GitHub)

Browse the full OpenAPI specification

When to Use OpenAPI Clients

Generated OpenAPI clients 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

FeaturePython OTEL SDKTypeScript API SDKHoneyHive CLIOpenAPI Client (Generated)
DependenciesOpenTelemetry + provider SDKsopenapi-fetch + axiosSingle binaryZero external dependencies
Auto-instrumentationYes (via BYOI)No - manual API callsN/ANo - manual API calls
Custom instrumentation@trace, enrich_span, enrich_sessionType-safe REST methodsN/AType-safe generated client
Context propagationAutomaticManualN/AManual
LanguagePythonTypeScript / Node.jsShell / CIAny language with an OpenAPI generator
Setup effortLow - auto-traces LLM callsLow - install and runLow - one binary, no runtimeLow - generate and use
Use caseMost Python applicationsTypeScript / Node.js applicationsAutomation, CI, and terminal workflowsOther languages, serverless, regulated environments

Getting Started

Quick Start Guide

Add tracing to your app in 5 minutes

Integrations

Browse framework and provider integrations