---
id: libhoney
version: "2.4.0"
license: Apache-2.0
license_treatment: permissive
maintenance: dormant
---

# libhoney — Python library for sending data to Honeycomb

License: permissive · Maintenance: dormant · Downloads: 420.9K/mo

## What it is and what it does

libhoney-py is a Python client library for sending structured events to Honeycomb, a cloud-based observability platform designed for debugging production software. It wraps HTTP calls over requests and urllib3 to deliver event data to Honeycomb's ingestion endpoints, allowing developers to instrument applications with custom metrics and trace data.

The library is lightweight and has low install friction—it ships as a pure Python wheel with only three runtime dependencies (requests, statsd, urllib3). It supports Python 3.7 through 3.11 and is maintained under the Apache License 2.0. While the package is dormant (no release since March 2024), the repository remains accessible and the code is stable for production use; for automatic instrumentation of frameworks like Django and Flask, Honeycomb recommends their separate Beeline for Python library.

Use it for:

- Instrument custom application events and send them to Honeycomb for real-time production debugging and performance analysis.
- Track application metrics and business events alongside system telemetry to correlate issues across your stack.
- Send trace data from backend services to Honeycomb for distributed tracing and request flow visualization.
- Log structured event data from long-running batch jobs or scheduled tasks for post-execution analysis.
- Integrate event collection into existing Python applications without heavy framework dependencies.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Sends events and metrics to Honeycomb, a production debugging service, for observability and analysis of application behavior.

Yes, if you use Honeycomb for observability. The package is stable, has low install friction, carries no known vulnerabilities, and is permissively licensed. The 891-day release gap is notable but not disqualifying—the library is mature and the repository remains maintained. For framework-specific automatic instrumentation, use Beeline for Python instead.

## Install

pip install libhoney
uv add libhoney
poetry add libhoney

## Installing libhoney

Before you install: Low install friction with pure Python wheels. Maintenance is dormant—last release was in March 2024, over 891 days ago, though the repository remains active with a recent commit in November 2024. Suitable for stable production use but expect no rapid updates.

License in practice: Apache License 2.0 (permissive). You may use, modify, and distribute this package freely in commercial and open-source projects, provided you retain the license notice.

Quickstart:

pip install libhoney

import libhoney
libhoney.init(writekey="your-api-key", dataset="your-dataset")
libhoney.send_now({"event_field": "value"})

Requires a Honeycomb account and API key to send events; without credentials, events will not be transmitted.

Verify before relying:

- Whether the 891-day gap since last release indicates planned maintenance cadence or abandoned support.
- Performance characteristics and event batching behavior under high-volume production workloads.
- Compatibility with recent Honeycomb API changes or deprecations since March 2024.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 420.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

send events to honeycomb, honeycomb python client, production observability sdk, application event tracking, honeycomb instrumentation, debug production software, event telemetry python, observability, honeycomb-client, event-telemetry

[View on SkillFed](https://skillfed.io/packages/libhoney) · [View on PyPI](https://pypi.org/project/libhoney/)