hoimin
hoimin is a mutation testing CLI for Python, designed for AI agents to improve tests locally within explicit resource budgets. It makes small changes to copies of your source and runs your tests to find behavior they do not check.
An agent investigates selected survivors, adds tests grounded in the intended behavior, and verifies the improvement. Humans provide specification decisions and review changes. Mutation scores are diagnostic observations; equivalent mutants and specification-permitted changes make them unsuitable as a standalone quality target. hoimin targets local work and provides no mutation-score or regression CI gate. A completed run exits successfully even when mutants survive; inspect the JSONL events to choose the next test improvement. See the product principles. See also the documentation for installation, the agent workflow, resource limits, and command references.
Install
uv tool install --python 3.14 hoimin
Wheels support Python 3.14 and 3.15 and support macOS Apple Silicon, Linux x86_64 (glibc), and Windows x86_64.
Use --python 3.15 to install with Python 3.15.
Python 3.15 lazy imports and unpacking in comprehensions are supported. Import-dependent mutations are conservative when lazy binding identity cannot be established.
Run uv tool update-shell if hoimin is not on PATH, then open a new shell.
Quick start
From your project directory, use a Python environment with passing tests and their dependencies installed.
Choose the OS memory policy first, then replace src/calc.py with an existing file:
hoimin run --root . --file src/calc.py -- python -m pytest -q
Everything after -- is your project's test command.
hoimin runs it once as a baseline, then for each selected mutation. Have your agent investigate a small batch of survivors for missing assertions or test cases; a survivor alone does not establish a test defect.
macOS and Linux without delegated cgroups require --allow-best-effort-memory before --; macOS memory is not capped. See the resource limits.
See the usage reference for selectors and configuration, the step-by-step plan/verify workflow for a Git-independent example with a before/after test improvement, and results, or run hoimin --help.
For questions and bug reports, see the reporting guide.
External Issues and pull requests are not accepted.
Licensed under Elastic License 2.0. See licensing details.
Startup cleanup reports
hoimin run and hoimin verify summarize startup cleanup in disk.janitor
(JSON/JSONL schema 10). Output includes bounded ordinary root retention details,
failures and unfinished cleanup diagnostics.
The summary separates roots from deleted entries and reports bounded scan/detail
omissions. It does not estimate remaining roots or freed disk space. See the
compatibility notice.
1 maintainer
Metadata
1 maintainer
Release files for hoimin 0.14.36
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hoimin-0.14.36-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| hoimin-0.14.36-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| hoimin-0.14.36-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 18.7 MB
Release files / hoimin-0.14.36-py3-none-win_amd64.whl
| Download URL | hoimin-0.14.36-py3-none-win_amd64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
682ba11adef1350c0332126e3860326be60c394270ce25efe682420eb98b2f2c
|
|
BLAKE2b-256 checksum How to use checksums |
f1ce48e8027ae89a38dec506c350b077d55d0c38b5ef637e6d7dbee7c9155b20
|
| 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 Oct 25, 2026.
Transparency log
SLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logRelease files / hoimin-0.14.36-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | hoimin-0.14.36-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
5fe3fabf6417c050c5e291dcfb7a2cf38f55b595b4ad26b09d6ccddc4a54c6ca
|
|
BLAKE2b-256 checksum How to use checksums |
14107716834bcdc2be3d5c74a026922ae21516129e7430089c7b38487494f62d
|
| 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 Oct 25, 2026.
Transparency logSLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logRelease files / hoimin-0.14.36-py3-none-macosx_11_0_arm64.whl
| Download URL | hoimin-0.14.36-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 5.9 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b26259d9a5fcc33750310ce7fe8eb465c0a8032d05dbffb8cbe2f1759bf67b28
|
|
BLAKE2b-256 checksum How to use checksums |
b7f97f346f33b22aa29d5dbd12c9004bdb2f5001d7c3e50ec3d5b2bb1013b479
|
| 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 Oct 25, 2026.
Transparency logSLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logSecurity for hoimin 0.14.36
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.
Full provenance
All 3 files in this release have been uploaded with provenance metadata.
Attestations for hoimin-0.14.36-py3-none-win_amd64.whl
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 Oct 25, 2026.
Transparency logSLSA Build Provenance Attestation
PyPI verified that this artifact, at this checksum, originated from the builder listed below.
Built by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
