hirundo · 
The Hirundo Python SDK lets you:
- Launch and monitor LLM behavior unlearning runs.
- Run LLM behavior evaluations for bias, hallucination, and prompt injection.
- Run dataset QA for ML datasets (classification, object detection, and more).
- Fetch QA results as
pandasorpolarsDataFrames.
This SDK requires access to a Hirundo server (SaaS, VPC, or on-prem).
Requirements
- Python 3.10, 3.11, 3.12, or 3.13 (CPython).
- A Hirundo API key.
Installation
pip install hirundo
Optional extras:
- LLM behavior unlearning (Transformers + PEFT):
pip install hirundo[transformers] - Dataset QA or LLM behavior eval results as DataFrames:
pip install hirundo[pandas]orpip install hirundo[polars]
If you want to install from source, clone this repository and run:
pip install .
Configure API access
You can set environment variables directly or use the CLI helper:
hirundo setup
This writes HIRUNDO_API_KEY (and optionally HIRUNDO_API_HOST) to .env in the current directory or ~/.hirundo.conf.
Quickstart examples
The full quickstart examples now live in the Sphinx docs so they can be linted,
formatted, and type-checked as real Python files. See the examples embedded in
docs/index.rst, which are sourced from docs/*.py files.
Supported dataset storage
- Amazon S3
- Google Cloud Storage (GCS)
- Git repositories with LFS (GitHub, Hugging Face)
Further documentation
- Documentation site: https://docs.hirundo.io/
- Example notebooks: notebooks/
2 maintainers
Metadata
2 maintainers
Release files for hirundo 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hirundo-0.3.1.tar.gz | 54.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hirundo-0.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 109.5 kB
Release files / hirundo-0.3.1.tar.gz
| Download URL | hirundo-0.3.1.tar.gz |
|---|---|
| Size | 54.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5b640287d270a4407198ea813b9b133438836c067f6cd3018fcad6feeb53793f
|
|
BLAKE2b-256 checksum How to use checksums |
7a2a413264fc05b2b6d66f521dda54b279d7df4015b5f4a763c466d90a89d7e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency logRelease files / hirundo-0.3.1-py3-none-any.whl
| Download URL | hirundo-0.3.1-py3-none-any.whl |
|---|---|
| Size | 55.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0445c6bb25028a3bc50270fdb57e874ce60c374e885e42134347afdf2fd74e81
|
|
BLAKE2b-256 checksum How to use checksums |
3587646fcbbfa2a7c4969dabbd26fd97d2ce9d1756f075091a9ff9022c89e1b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency log
