Ansible Development Tools

26.4.6 verified Fri May 01 auth: no python

A meta-package that bundles all essential tools for Ansible content creation and testing, including ansible-core, ansible-lint, molecule, and more. Current version 26.4.6 requires Python >=3.11 and adopts a new CLI entry point. Released roughly quarterly.

pip install ansible-dev-tools

Common errors

error ModuleNotFoundError: No module named 'ansible_dev_tools' ↓

cause The package was not installed, or installed in a different Python environment.

fix

Run pip install ansible-dev-tools in the correct virtual environment, or use pipx install ansible-dev-tools.

error Command 'ansible-dev-tools' not found ↓

cause The CLI entry point is missing because the package is not installed in the PATH's Python environment.

fix

Ensure the package is installed. If using pipx, make sure pipx ensurepath was run. Or use python -m ansible_dev_tools instead.

error ImportError: cannot import name 'AnsibleDevTools' from 'ansible_dev_tools' ↓

cause An older version installed (pre-24.0.0) where the class name was different or the import path was different.

fix

Upgrade to the latest version: pip install --upgrade ansible-dev-tools

Warnings

breaking Version 24.0.0 dropped Python 3.8 and 3.9 support. Requires Python >=3.10 (now 3.11+ in 26.x). ↓

fix Upgrade to Python 3.11 or later.

breaking The CLI interface changed from `ansible-dev-tools-cli` to `ansible-dev-tools`. All command line invocations must be updated. ↓

fix Use `ansible-dev-tools --help` instead of `ansible-dev-tools-cli --help`.

gotcha This is a meta-package; individual tools (like ansible-lint, molecule) must still be installed separately if not included. The meta-package pins compatible versions. ↓

fix Install ansible-dev-tools to get a compatible set, but do not rely on it for all Ansible dependencies.

Install

pipx install ansible-dev-tools

Imports

AnsibleDevTools
wrong
```
import ansible_dev_tools
```
correct
```
from ansible_dev_tools import AnsibleDevTools
```
The top-level package exposes a single class or entry, not a module.
cli entry point
wrong
```
ansible-dev-tools-cli
```
correct
```
ansible-dev-tools --help
```
The CLI is invoked via `ansible-dev-tools`, not a separate script.

Quickstart

Initialize the tools manager and list bundled tools.

from ansible_dev_tools import AnsibleDevTools

tools = AnsibleDevTools()
print(tools.list_tools())