---
id: humiolib
version: "0.2.6"
license: Apache-2.0
license_treatment: permissive
maintenance: dormant
---

# humiolib — Python SDK for connecting to Humio

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

## What it is and what it does

humiolib is a Python wrapper around Humio's web API designed to simplify log ingestion and querying workflows. It provides two main client classes: HumioClient for performing queries and managing Humio instances, and HumioIngestClient for sending both unstructured and structured log data into Humio. The library abstracts away HTTP details and provides higher-level interfaces like streaming queries, query jobs with polling, and batch ingestion methods.

The package depends on requests for HTTP communication, pytest for testing, and vcrpy for mocking API calls in tests. It supports Python 3.5 and later across Windows, POSIX, and Unix systems. Development is dormant but the codebase is marked as production-stable; it is suitable for teams already committed to Humio who need a Python-native way to interact with the platform.

Use it for:

- Ingest application logs and system events into Humio from Python services or batch jobs.
- Query Humio logs programmatically within Python scripts or notebooks for analysis and alerting.
- Build streaming log processors that consume live Humio query results in real time.
- Automate log management tasks like file uploads or saved query management via Python.
- Integrate Humio log access into Python-based monitoring or observability pipelines.

## Worth the install?

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

Python SDK that wraps Humio's web API to enable log ingestion and querying directly from Python code.

Yes, if you are already using Humio and need Python-native API access. The package is stable (Production/Stable classifier), has no known vulnerabilities, and low install friction. However, dormant maintenance means you should verify compatibility with your Humio instance and Python environment before relying on it for critical workflows. Not suitable if you need active development or frequent updates.

## Install

pip install humiolib
uv add humiolib
poetry add humiolib

## Installing humiolib

Before you install: Low install friction with a pure-wheel distribution. Maintenance is dormant—last release was 2023-10-05, though the repository remains active with a recent commit on 2024-06-05. Suitable for stable use cases but expect no active development.

License in practice: Licensed under Apache-2.0 (permissive), which allows commercial and private use with minimal restrictions. No licensing barrier to adoption.

Quickstart:

pip install humiolib

from humiolib.HumioClient import HumioClient

client = HumioClient(
    base_url="https://cloud.humio.com",
    repository="sandbox",
    user_token="your_token")

webStream = client.streaming_query("Login Attempt Failed", is_live=True)
for event in webStream:
    print(event)

Requires a valid Humio account and authentication token; base_url and repository must be configured for your Humio instance.

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.8 despite classifiers claiming support through 3.8.
- Current state of compatibility with modern versions of requests, pytest, and vcrpy dependencies.
- Whether dormant maintenance status poses a risk for bug fixes if issues arise with Humio API changes.

## Package facts

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

## Tags

humio python client, log ingestion sdk, humio api wrapper, log query python, humio streaming queries, structured log ingest, humio rest client, log-management, humio-integration, api-wrapper

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