March 2026
Python SDK
v1.0.0rc19
- Export operations (
export(),export_async(),get_by_session_id()) no longer time out on large result sets. The default read timeout is now 5 minutes instead of 5 seconds. - New
HH_EXPORT_TIMEOUT_SECONDSenvironment variable to override the default export timeout for extremely large exports or constrained network environments
February 2026
Python SDK
v1.0.0rc18
- Large query batching: list operations like
datapoints.list()andexperiments.list_runs()now automatically batch when exceeding 100 items, merging results transparently. No API changes needed, existing code works as before without silent truncation or HTTP errors on large lists. - SDK identification headers (
hh-sdk-version,hh-sdk-language,hh-sdk-package) sent on all HTTP requests for better debugging and support diagnostics
January 2026
Core Platform
Introducing Workspaces
HoneyHive now organizes your account into three levels: Organization > Workspace > Project. Workspaces are a new layer between your organization and projects, designed to map to how your company actually operates - one workspace per business unit, team, or department. Each workspace gets its own AI provider keys, access controls, and data boundaries, so the ML platform team, product team, and compliance team can all work independently under one organization.A new org/workspace switcher replaces the logo in the top navigation, letting you move between organizations and workspaces in two clicks.Learn more about the organization hierarchyWorkspace-Scoped AI Provider Keys
AI provider keys have moved from the organization level down to the workspace level. Configure your OpenAI, Anthropic, Azure OpenAI, Bedrock, Gemini, or Vertex AI credentials per workspace in Settings > Workspace > AI Providers.This tightens your security posture and unlocks per-team cost attribution:- Smaller blast radius - A compromised key only affects one workspace, not your entire organization. Workspace Admins manage their own keys without needing org-level access.
- Cost attribution by team - Each workspace uses its own provider keys, so API spend maps directly to the business unit, department, or team that owns the workspace. No more splitting a shared org bill across teams.
- Right provider for the right team - One team can use Azure OpenAI to meet compliance requirements while another runs on AWS Bedrock. Each workspace’s provider configuration is fully independent.
Enterprise-Grade Role-Based Access Control
A new permission system replaces the previous four-role hierarchy (Org Admin > Project Admin > Project Member > Org Member) with independent roles at each scope level and 100+ granular permissions.Flat, Non-Cascading Permissions
Permissions no longer inherit across levels. An Org Admin must be explicitly added to a workspace and project to access its data. Each scope is independently controlled.
Dual-Control Access Model
Both membership and a role with the right permissions are required to access any resource. Neither condition alone is sufficient.
Workspace-Level Roles
Workspace Admins and Members join Org and Project roles as the new middle layer. Control who can manage AI provider keys, create projects, and invite team members within a workspace.
Custom Roles (Enterprise)
Define custom roles with granular permission sets that match your team’s specific access requirements. The platform supports 100+ individual permissions across all scope levels.
Introducing Organization Templates
Enterprise organizations can now define templates that control which evaluators and charts are auto-created when new workspaces and projects are created. Instead of every team starting from scratch or copy-pasting setup from another project, Org Admins configure a standard set of evaluators and monitoring charts once, and they automatically populate when new workspaces and projects are created across the organization.This gives platform teams a way to enforce consistency at scale - standardize quality metrics across business units, ensure every new project ships with the right monitoring dashboards, and reduce onboarding time for teams spinning up new AI applications.Org Admins define templates via a YAML manifest in Settings > Organization > Templates. Every new project starts with the evaluators and monitoring charts you specify - ready to go from day one.Organization Templates require the Enterprise plan.
LLM Evaluators with Workspace Provider Defaults
LLM evaluators now pull from your workspace’s configured AI provider keys instead of org-level credentials. Default provider and model values are pre-selected based on your workspace configuration, so evaluators work out of the box as soon as a provider key is set up.Learn more about LLM evaluatorsOther Improvements
- Visibility toggle on input fields and improved dialog interactions
- ClickHouse query performance improvements
- Log Store UI fixes
- Security-related fixes
- Form validation improvements
Python SDK
v1.0.0rc17
- Git context automatically stamped on experiment runs (commit hash, branch, author, remote URL, dirty status)
- Custom
run_idsupport inevaluate()for using your own identifiers - Auto-infer
is_evaluation=Truewhendataset_id,datapoint_id, andrun_idare all provided, preventing silent loss of evaluation context export_async()now retries on transient HTTP errors (502, 503, 504), matchingexport()behavior- Debug logging for
get_by_session_idand export flows (entry/exit, HTTP metadata, empty result diagnostics) - Removed non-functional
include_datapointsquery param - Synced OpenAPI spec and removed defunct Tools API client
- Fixed single-item list query param serialization causing 400 errors
v1.0.0rc16
- Fixed import errors and
AttributeErrorin events and context modules - Events API fixes: ordering, project deprecation handling,
enrich_spanevent ID resolution - Corrected
evaluate()docstrings to match actual function signature
v1.0.0rc15
- New
flush()method onHoneyHiveTracerfor explicitly flushing pending spans before application shutdown - New
get_by_session_id()method on Events API for retrieving all events for a given session using the Data Plane export endpoint enrich_span()now supportsupdate_event_idparameter for overriding a span’s event_id attribute without making API calls- Events returned in chronological order by default;
projectparameter deprecated in favor of project-scoped API keys - Pydantic models now preserve extra fields from API responses (
extra="allow"), preventing data loss when backend returns additional fields
v1.0.0rc9
- Auto-generated type-safe v1 API client from OpenAPI spec with full Pydantic models for all requests/responses, sync and async methods, and new endpoint support (batch events, experiment results/comparison, project CRUD)
- Backwards-compatible API aliases: all API classes support both new (
list(),create(),get()) and legacy (list_datasets(),create_dataset()) method names - OTLP HTTP/JSON export is now the default format (changed from
http/protobuf), configurable viaHH_OTLP_PROTOCOLorOTEL_EXPORTER_OTLP_PROTOCOLenvironment variables evaluate()now accepts aninstrumentorsparameter to auto-instrument third-party libraries (OpenAI, Anthropic, Google ADK, LangChain, etc.) per datapointevaluate()now accepts async functions, automatically detected and executed withasyncio.run()inside worker threads- Typed Pydantic models for experiment results (
MetricDetail,DatapointResult,DatapointMetric) - Fixed metrics table printing empty values after
evaluate()by aligning with backend’sdetailsarray format - Fixed
enrich_session()silently failing when called without explicit parameters
December 2025
Python SDK
v1.0.0rc5
- Metric schema updated for backend parity: new type enums (
PYTHON/LLM/HUMAN/COMPOSITE),categoricalreturn type, and new fields (sampling_percentage,scale,categories,filters) - Enhanced datapoints filtering with
dataset_idanddataset_nameparameters; legacydatasetparameter auto-detects ID vs. name EventsAPI.list_events()now accepts a singleEventFilteror a list, converting automatically- Simplified distributed tracing setup with
with_distributed_trace_context()context manager (reduces server-side boilerplate from ~65 lines to 1 line) - Fixed
@tracedecorator overwriting distributed trace baggage (session_id,project,source) instead of preserving it - Configurable OpenTelemetry span limits via
TracerConfigor environment variables (HH_MAX_ATTRIBUTES,HH_MAX_EVENTS,HH_MAX_LINKS) - Automatic preservation of critical HoneyHive attributes (
session_id,event_type,event_name,source) when spans approach the attribute limit - Fixed session ID initialization when explicitly providing a
session_idtoHoneyHiveTracer.init()
October 2025
Core Platform
Experiments Dashboard
Visualize metric trends across all your experiments in a single unified view.
Cross-Experiment Comparison
View and compare metrics across 100+ experiments simultaneously. See results from experiments using different prompts, models, and retrieval parameters side-by-side.
Performance Regression Detection
Identify when changes negatively impact your application’s quality metrics. Metric trends make it easy to spot regressions at a glance.
Parameter Sweep Visualization
Track how sweeps across different configurations (prompts, models, retrieval parameters) impact performance over time.
Unified Analytics
Analyze experiment results without jumping between individual experiment pages. All your experiment data in one place for faster, data-driven decision making.
Annotation Queues
Automated trace collection and streamlined human evaluation workflows.
Automatic Queue Population
Configure filters to automatically add traces matching specific criteria to annotation queues. The system continuously runs in the background, identifying traces that need human review.
Streamlined Evaluation Interface
Domain experts can evaluate traces based on predefined criteria fields. Use ← → arrow keys for quick navigation between events during high-volume annotation tasks.
Queue Management
Build high-quality datasets and maintain consistent human oversight of your AI applications with organized evaluation workflows.
Improved Evaluators UX

New Evaluator Templates
Expanded evaluator templates library with 11 new pre-built templates for common evaluation patterns.| Category | Evaluators |
|---|---|
| Agent Evaluation | • Chain-of-Thought Faithfulness • Plan Coverage • Trajectory Plan Faithfulness • Failure Recovery |
| Safety | • Policy Compliance • Harm Avoidance |
| RAG | • Context Coverage |
| Text Evaluation | • Tone Appropriateness |
| Translation | • Translation Fluency |
| Code Generation | • Compilation Success |
| Classification Metrics | • Precision/Recall/F1 Metrics |
September 2025
Core Platform
Improved Review Mode
Enhanced context indicators in Review Mode that clearly show which output type you’re evaluating.
Model Outputs
Evaluate individual LLM responses with clear context about the model being reviewed.
Session Outputs
Review end-to-end agent interactions and complete conversation flows.
Tool Outputs
Assess function and API call results with full execution context.
Chain/Workflow Outputs
Analyze multi-step process results and complex execution paths.
Categorical Evaluators
New evaluator type that enables classification-based human evaluation with custom scoring.
Pass/Fail Analysis
Create binary classifications with associated scores for clear go/no-go decisions.
Regression Detection
Track when outputs shift from high-scoring to low-scoring categories over time.
Multi-Class Evaluation
Define multiple categories representing different quality levels or response types.
August 2025
Core Platform
Thread View
New visualization mode that displays all LLM events and chat history in a unified, chronological timeline.
Unified Conversation View
View all LLM events alongside complete chat history in a single interface. Understand the full context of multi-turn conversations without navigating through nested spans.
Automatic Agent Handoff Detection
The system automatically identifies when control passes between different LLM workflows or agents, highlighting transition points in complex multi-agent systems.
Session-Level Feedback
Domain experts can provide feedback at the session level, which is automatically applied to the root span (session event) in the trace.
Improved Graph View
Major enhancements to Graph View with automatic node deduplication and new analytical features.
Automatic Node Deduplication
The graph now intelligently deduplicates nodes, simplifying visualization of complex agent trajectories.
Graph Statistics
View total number of nodes, state transitions, and structural complexity metrics for your agent workflows.
Weighted Edges
Edge thickness represents execution frequency, making common paths immediately visible.
Latency Bottlenecks
Identify which nodes are causing performance issues in your agent workflows.
Common Trajectories
Visualize the most frequent paths through your agent’s decision tree to understand typical execution patterns.
Introducing Alerts
Monitor key metrics and get notified when behavior changes in your AI applications.
- Comprehensive Monitoring: Track performance metrics (latency, error rate), quality scores from evaluators, cost and usage patterns, plus any custom fields from your events or sessions. Get visibility into what matters most for your AI applications.
- Smart Alert Types: Aggregate Alerts trigger when metrics cross absolute thresholds, while Drift Alerts detect when current performance deviates from previous periods by a configurable percentage. Choose the right detection method for your use case.
- Flexible Scheduling: Configure alerts to run hourly, daily, weekly, or monthly based on your monitoring needs. Set custom evaluation windows to balance responsiveness with noise reduction.
- Streamlined Workflow: Real-time preview charts show exactly what your alert will monitor, guided configuration in the right panel walks you through setup, and a recent activity feed tracks alert history. Manage alert states (Active, Triggered, Resolved, Paused, Muted) directly from each alert’s detail page.
Evaluator Templates Gallery
Quick-start your evaluations with pre-built templates organized by use case: Agent Trajectory, Tool Selection, RAG, Summarization, Translation, Structured Output, Code Generation, Performance, Safety, and Traditional NLP.
July 2025
Core Platform
New Trace Visualization Modes
-
Session Summaries and New Tree View:
Unified view of metrics, evaluations, and feedback across all spans in an agent session. Get a comprehensive overview without jumping between individual spans to understand overall session performance.

-
Timeline View:
Flamegraph visualization that identifies latency bottlenecks and shows the relationship between sequential and parallel operations in your agent workflows. Perfect for performance optimization and understanding execution flow.

-
Graph View:
Visual representation of complex execution paths and decision points through multi-agent workflows. Quickly understand how your agents interact and make decisions at a glance.

Improved Log Store Analytics
Volume Charts: New mini-charts display request volume patterns over time directly in the sessions table, providing instant visibility into traffic trends and activity levels without needing to drill into individual sessions.
June 2025
Core Platform
Role-Based Access Control (RBAC)

- Two-Tier Permission Structure: Granular permission management with organization and project-level controls. Organization Admins have full control across the entire organization, while Project Admins maintain complete control within specific projects. This creates clear boundaries between teams and prevents data leakage between business units.
- Enhanced API Key Security: Project-specific API key scoping ensures that teams can only access data within their designated projects. This provides better security isolation and compliance with industry regulations, especially critical for organizations in financial services, healthcare, and insurance.
- Flexible Team Management: Easy onboarding and role transitions with transparent permission hierarchy. Delegate administrative responsibilities without compromising security, and manage team member access as organizations evolve.
- Seamless Migration Process: Existing customers can migrate to RBAC with minimal disruption. All current users are automatically assigned Organization Admin roles, and project-specific API keys are available in Settings. Legacy API keys will remain functional until August 31st, 2025.
May 2025
Core Platform
- Added list of allowed characters for project names
Python SDK (Logger)
HoneyHive Logger (honeyhive-logger) released
- The logger sdk has
- No external dependencies
- A fully stateless design
- Optimized for
- Serverless environments
- Highly regulated environments with strict security requirements
TypeScript SDK (Logger)
HoneyHive Logger (@honeyhive/logger) released
- The logger sdk has
- No external dependencies
- A fully stateless design
- Optimized for
- Serverless environments
- Highly regulated environments with strict security requirements
Python SDK - Version [v0.2.49]
- Added type annotation to decorators and the evaluation harness
Documentation
- Added documentation for Python/Typescript Loggers
- Updated gemini integration documentation to use latest sdk (Python and TypeScript)
April 2025
Core Platform
Support for External Datasets in Experiments
You can now log experiments using external datasets with custom IDs for both datasets and datapoints. External dataset IDs will display with the “EXT-” prefix in the UI. This feature provides greater flexibility for teams working with custom datasets while maintaining full integration with our experiment tracking.- Bug fixes and improvements across various areas to enhance performance and stability.
- Bug fixes for playground & evaluator version controls.
Documentation
- Standardizes parameter names and clarified evaluation order in Experiments Quickstart and Python/TS SDK docs.
- Adds cookbook: Inspirational Quotes Recommender with Qdrant and OpenAI
- Adds an “Evaluating External Logs” tutorial.
- Updates Python and TypeScript SDK’s references and overall documentation to align with recent improvements and best practices.
- Adds Datasets Introduction Guide.
- Adds Server-side Evaluator Templates List documentation.
- Adds LangGraph integration documentation.
March 2025
Core Platform
Wide Mode
We’ve introduced a new Wide Mode option that allows users to hide the sidebar, providing:- Expanded workspace area for a more immersive viewing experience
- Distraction-free environment when focusing on complex tasks
- Better content visibility on smaller screens and split-window setups
- Toggle controls accessible via the header menu for easy switching
Improved Experiments Layout
Our redesigned comparison interface improves result analysis with:- Structured input visualization with collapsible sections
- Clear side-by-side metrics display for easier model comparison
- Improved performance statistics with visual rating indicators
Introducing Review Mode
A new way for domain experts to annotate traces with human feedback.With Review Mode, you can:- Tag traces with annotations from your Human Evaluators definitions
- Apply your custom criteria right in the UI
- Add comments when something interesting pops up
Experiments and Log Store - look for the “Review Mode” button.- Enhanced filter functionality: Added the ability to edit filters and improved schema discovery within filters.
- Fixed pagination issue for events table.
- Bug fixes and stability improvements for filtering functionality.
- Added support for
existsandnot existsoperators in filters. - Frontend styling improvements to enhance the user interface.
- Bug fixes and stability enhancements for a smoother user experience.
Python SDK - Version [v0.2.44]
- Improved error tracking for the tracer: Enhanced the capture of error messages for custom-decorated functions.
- Git context enrichment: Added support for capturing Git branch status in traces and experiments.
- Introduced the
disable_http_tracingparameter during tracer initialization to disable HTTP event tracing. - Fixed the
traceloopversion to 0.30.0 to resolve protobuf dependency conflicts.
Python SDK - Version [v0.2.36]
- Reduced package size for AWS lambda usage
- Removed Langchain dependency. For using Langchain callbacks, install Langchain separately
- Add lambda, core, and eval poetry installation groups
TypeScript SDK - Version [v1.0.33]
- Improved error tracking for the tracer: Enhanced the capture of error messages for traced functions.
- Git context enrichment: Added support for capturing Git branch status in traces and experiments.
- Introduced the
disableHttpTracingparameter during tracer initialization to disable HTTP event tracing.
TypeScript SDK - Version [v1.0.23]
- Reduced package size for AWS lambda usage
- Disabled CommonJS autotracing 3rd party packages: Anthropic, Bedrock, Pinecone, ChromaDB, Cohere, Langchain, LlamaIndex, OpenAI. Please use custom tracing for instrumenting Typescript.
- Refactor custom tracer for better initialization syntax and using typescript
Documentation
- Improved documentation for async function handling.
- Added integration documentation for model providers:
- Added a tutorial for running experiments with multi-step LLM applications with MongoDB and OpenAI.
- Adds Streamlit Cookbook for tracing model calls with collected user feedback on AI response.
- Standardized all JavaScript/TypeScript code examples to TypeScript across the documentation.
- Added troubleshooting guidance for SSL validation failures.
- Documented the
disable_http_tracing/disableHttpTracingparameter in the SDK Reference. - Removed references to
init_from_session_idin favor of usinginitwith thesession_idparameter. - Updated the observability tutorial/cookbook to use
enrichSessioninstead ofsetFeedback/setMetadata - Integrations - added CrewAI Integration documentation.
- Added schema documentation (now part of Enrichment Schema) to describe our schemas in detail including a list of reserved properties.
- Added Client-side Evaluators documentation to describe the use of client-side evaluators for both tracing and experiments
- Updated Custom Spans documentation to add reference to tracing methods
traceModel/traceTool/traceChain(TypeScript) - Integrations - added LanceDB Integration documentation
- Integrations - added Zilliz Integration documentation

