---
id: ansible-dev-environment
version: "26.8.0"
license: GPL-3.0-only
license_treatment: copyleft
maintenance: active
---

# ansible-dev-environment — A pip-like ansible collection installer.

License: copyleft · Maintenance: active · Downloads: 582.1K/mo

## What it is and what it does

ansible-dev-environment (ade) is a workspace isolation tool for Ansible collection development. It creates project-specific virtual environments and manages both Ansible collections and their Python dependencies, solving the problem of version conflicts when developing multiple collections with different requirements. The tool installs collections into the virtual environment's site-packages, making them discoverable by Ansible, Python tooling, and pytest while keeping them isolated from global collection directories.

The core problem it addresses is Ansible's collection search path behavior: Ansible prioritizes global collection locations (like ~/.ansible/collections) over virtual environment paths, causing silent version conflicts where your development code is overridden by older global versions. ade provides three isolation modes—cfg (default, creates ansible.cfg), restrictive (fails if global collections exist), and none—to ensure your virtual environment's collections take precedence. It complements ansible-galaxy by handling Python package dependencies that collections require, creating reproducible development setups across team members.

Use it for:

- Develop a collection with specific Python package versions (e.g., requests==2.25.0) without affecting other projects on the same machine
- Set up a reproducible development environment for a team where each developer uses the same collection and dependency versions
- Test a collection against multiple Python versions (3.10, 3.11, 3.12, 3.13) by creating separate virtual environments with --python
- Install a collection in editable mode with symlinks for active development, allowing code changes to be immediately reflected
- Prevent debugging confusion caused by Ansible loading older collection versions from global paths instead of your development code
- Manage complex dependency trees where collections have conflicting requirements that would fail in a shared environment

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Creates isolated virtual environments for Ansible collection development, managing collection installation, Python dependencies, and workspace isolation to prevent version conflicts.

Yes. The package is actively maintained (released 2 days ago), production-stable, has no known vulnerabilities, and solves a real problem in Ansible collection development—preventing version conflicts through workspace isolation. Low installation friction and broad Python version support (3.10–3.13) make it accessible. The copyleft license is a consideration only if you plan to redistribute modifications; for development use, it poses no barrier.

## Install

pip install ansible-dev-environment
uv add ansible-dev-environment
poetry add ansible-dev-environment

## Installing ansible-dev-environment

Before you install: Low friction installation with a pure Python wheel. Active maintenance—released 2 days ago with 72 repository stars. Requires Python 3.10 or later and depends on ansible-builder, bindep, pyyaml, and subprocess-tee, all standard tools in the Ansible ecosystem.

License in practice: Licensed under GPL-3.0-only (copyleft). Any modifications or derivative works must be distributed under the same license; proprietary use is not permitted.

Quickstart:

pip install ansible-dev-environment

cd /path/to/collection
ade install -e . --venv .venv

# Activate and use
source .venv/bin/activate
ansible-playbook playbooks/test.yml

Requires Python 3.10 or later; ansible-builder, bindep, pyyaml, and subprocess-tee must be installable in the target environment.

Verify before relying:

- Whether the tool works with all Ansible core versions or has specific version constraints beyond what the description states
- Performance characteristics when managing large numbers of collections or complex dependency trees
- Compatibility with non-CPython implementations (PyPy, etc.) despite Python 3.10+ support

## Package facts

- License: GPL-3.0-only (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 582.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ansible collection development environment, isolated ansible workspace setup, ansible collection dependency management, ansible dev environment manager, collection installation with isolation, ansible venv configuration, ansible development isolation, ansible-collections, environment-isolation, dependency-management

[View on SkillFed](https://skillfed.io/packages/ansible-dev-environment) · [View on PyPI](https://pypi.org/project/ansible-dev-environment/)