humiolib

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 on this page — 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

humiolib on PyPI

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

Evidence: humiolib-0.2.6-py2.py3-none-any.whl

Keywords: humio, log management

Tags

More Monitoring packages