About Ansible Molecule
Molecule is an Ansible testing framework designed for developing and testing Ansible collections, playbooks, and roles.
Molecule leverages standard Ansible features including inventory, playbooks, and collections to provide flexible testing workflows. Test scenarios can target any system or service reachable from Ansible, from containers and virtual machines to cloud infrastructure, hyperscaler services, APIs, databases, and network devices. Molecule can also validate inventory configurations and dynamic inventory sources.
Molecule encourages an approach that results in consistently developed Ansible content that is well-written, easily understood and maintained.
Molecule supports only the latest two major versions of Ansible (N/N-1).
Once installed, the command line can be called using any of the methods below:
molecule ...
python3 -m molecule ... # python module calling method
Documentation
Read the documentation and more at https://docs.ansible.com/projects/molecule//.
Get Involved
See the Talk to us section of the documentation to ask questions, find help, and join the conversation.
For complete details, see the Ansible communication guide.
If you want to get moving fast and make a quick patch:
git clone https://github.com/ansible/molecule && cd molecule
python3 -m venv .venv && source .venv/bin/activate
python3 -m pip install -U setuptools pip tox
And you're ready to make your changes!
Authors
Molecule project was created by Retr0h and it is now community-maintained as part of the Ansible by Red Hat project.
License
The MIT License.
The logo is licensed under the Creative Commons NoDerivatives 4.0 License.
If you have some other use in mind, contact us.
Release files for molecule 26.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| molecule-26.9.0.tar.gz | 4.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| molecule-26.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.9 MB
Release files / molecule-26.9.0.tar.gz
| Download URL | molecule-26.9.0.tar.gz |
|---|---|
| Size | 4.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c44254eb173d0a3a48217b874d19bfa436614fb0c6faa75d9b192a843360188
|
|
BLAKE2b-256 checksum How to use checksums |
87ebef1f1a0eba6e2fac4e59001c539109bc65c4dcd1b8a9d2b93c9097241d71
|
| 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 22, 2026.
Transparency logRelease files / molecule-26.9.0-py3-none-any.whl
| Download URL | molecule-26.9.0-py3-none-any.whl |
|---|---|
| Size | 163.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad8f468c01f35a27cd12858e24c86ad27344dc1076845f03d78fdb563fb69f82
|
|
BLAKE2b-256 checksum How to use checksums |
4eb74041d1b53467e12a4fd72ae7e0bb8ccc2909e126e2bb0cf2babcae82cc41
|
| 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 22, 2026.
Transparency log
