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. 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 require Python 3.14 and support macOS Apple Silicon, Linux x86_64 (glibc), and Windows x86_64.
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 --format human -- 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.
1 maintainer
Metadata
1 maintainer
Release files for hoimin 0.11.12
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.11.12-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| hoimin-0.11.12-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| hoimin-0.11.12-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 18.4 MB
Release files / hoimin-0.11.12-py3-none-win_amd64.whl
| Download URL | hoimin-0.11.12-py3-none-win_amd64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
595dc340b8e092a4df279ccfac1eb8e2af42f6625feec859f2e7d69f6fa63cec
|
|
BLAKE2b-256 checksum How to use checksums |
c841036bfeec00fb7c1d497c54771af9bebe79afce816fea7ca1e3ef3f8aedc8
|
| 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 18, 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 18, 2026.
Transparency logRelease files / hoimin-0.11.12-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | hoimin-0.11.12-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
5d9fadad0c92ff25ed882d35b3e0c7534ce9a04213e84cdf7064d684b4d2ae70
|
|
BLAKE2b-256 checksum How to use checksums |
8a7f0a4ee2098a93bfe81fdc4aecda494cb1f030e5d82d614926a0b11a10545a
|
| 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 18, 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 18, 2026.
Transparency logRelease files / hoimin-0.11.12-py3-none-macosx_11_0_arm64.whl
| Download URL | hoimin-0.11.12-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 5.8 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
cb0d7735571f18e06a1097c8a43590fc3646af5ebf1ef69a581bc3ee3dbd3ed5
|
|
BLAKE2b-256 checksum How to use checksums |
dc8c37f057ff94a5b3c47ea6a217b625216119bf113e7520f71b265ad8624e42
|
| 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 18, 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 18, 2026.
Transparency log
