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. CI use is optional. See the product principles.
Browse the documentation for installation,
the agent workflow, resource limits, and command references. The site tracks
main; for a particular release, read the Markdown at that release's Git tag.
Maintainers can follow the publication guide.
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.
For maintainer development, see development
and building and releases.
Licensed under Elastic License 2.0. See licensing details.
1 maintainer
Metadata
1 maintainer
Release files for hoimin 0.5.0
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.5.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| hoimin-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| hoimin-0.5.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 19.5 MB
Release files / hoimin-0.5.0-py3-none-win_amd64.whl
| Download URL | hoimin-0.5.0-py3-none-win_amd64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a98ac98abb804d79d0d7146456cfea0084155da06937518029d3dcf0b69dbb38
|
|
BLAKE2b-256 checksum How to use checksums |
688849ee247f6eda074b9b4734e3eebdfeda37e44daf356739ad5c4200dca251
|
| 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 13, 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 13, 2026.
Transparency logRelease files / hoimin-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | hoimin-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
0158e3f0bb46bbd92e35ea9d4c5f46b99e44908a88e160a707081c01b3a4d988
|
|
BLAKE2b-256 checksum How to use checksums |
068c946505d25307da470fe56e1589b6a9a69e7de94868a37e728798082ad657
|
| 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 13, 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 13, 2026.
Transparency logRelease files / hoimin-0.5.0-py3-none-macosx_11_0_arm64.whl
| Download URL | hoimin-0.5.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d0ae4ba38880699b63536d104817a4087630ff35245166d7db47615eec5eb137
|
|
BLAKE2b-256 checksum How to use checksums |
fe34adeb0fbd4b7d911d600d5796b78397075f1520ce5366a10568048f7f69d2
|
| 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 13, 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 13, 2026.
Transparency log
