---
id: ansible-navigator
version: "26.8.0"
license: Apache
license_treatment: permissive
maintenance: active
---

# ansible-navigator — A text-based user interface (TUI) for the Red Hat Ansible Automation Platform

License: permissive · Maintenance: active · Downloads: 468.0K/mo

## What it is and what it does

ansible-navigator is a curses-based terminal UI that wraps Ansible, letting you run playbooks, browse collections, inspect inventory, and read documentation interactively. Instead of running separate ansible commands and parsing their output, you navigate through a structured interface where you can zoom in on data, filter results, and explore relationships between Ansible components in real time.

The tool runs in two modes: interactive (the default, with a full TUI) and stdout (plain terminal output). By default it uses a container runtime to execute Ansible in an execution environment, which keeps your system clean and reproducible; you can disable this with a flag to run Ansible directly on your machine. It depends on ansible-runner, ansible-builder, ansible-lint, and standard libraries like jinja2, jsonschema, and pyyaml.

Use it for:

- Interactively debug and explore a playbook's execution, stepping through tasks and inspecting variables in real time.
- Browse available Ansible collections and their documentation without switching to a web browser or separate docs tool.
- Explore and validate an inventory file visually, filtering hosts and groups to understand your infrastructure layout.
- Review Ansible configuration and documentation inline while working on automation tasks.
- Run playbooks with integrated output exploration, allowing you to drill into task results without re-running or post-processing.

## Worth the install?

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

ansible-navigator is a text-based user interface (TUI) for Ansible that lets you interactively explore playbooks, collections, inventory, and configuration without leaving the terminal.

Yes. ansible-navigator is actively maintained, has low install friction, carries no known vulnerabilities, and offers genuine value if you spend time in the terminal with Ansible. The Apache 2.0 license is permissive. The main gotcha is the default container runtime requirement—confirm your environment has podman or docker, or plan to use local execution mode.

## Install

pip install ansible-navigator
uv add ansible-navigator
poetry add ansible-navigator

## Installing ansible-navigator

Before you install: Low install friction: pure Python wheel with 9 runtime dependencies. Actively maintained with a release 2 days ago and 544 repository stars. Requires Python 3.10 or later.

License in practice: Released under Apache License 2.0 (permissive), which allows commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install 'ansible-navigator[ansible-core]'
ansible-navigator --help
ansible-navigator run site.yaml -i inventory.yaml

By default runs Ansible in a container (podman or docker required); use --execution-environment false to run locally, but then Ansible and collections must be installed manually on the system.

Verify before relying:

- Whether the container runtime requirement (podman/docker) is a blocker for your environment or if local execution mode is sufficient for your workflow.
- Performance characteristics when browsing large inventories or collections in interactive mode.

## Package facts

- License: Apache (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 468.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ansible tui terminal interface, ansible interactive explorer, ansible playbook debugger, ansible collection browser, ansible curses interface, ansible cli explorer, ansible inventory viewer, ansible documentation browser, ansible-tooling, terminal-ui, infrastructure-automation

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