Registry / devops / ansible-navigator

ansible-navigator

library26.4.0pypypi✓ verified 80d ago

A text-based user interface (TUI) for the Red Hat Ansible Automation Platform. Provides an interactive curses-based interface for running, reviewing, and debugging Ansible playbooks, inventories, and collections. Current version: 26.4.0, requires Python >=3.10. Release cadence follows Ansible Automation Platform releases.

devops

pip install ansible-navigator

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · ANSIBLE-NAVIGATOR

ansible-navigator

devopspythonv26.4.0

Install

8.4s avg

Import

—

Disk

95MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v26.4.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

build_error

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 8.4s · import 0.000s · 86MB

95MB installed

● package 95MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

AnsibleNavigator

✓ import ansible_navigator

✗ from ansible_navigator import AnsibleNavigator

Launch the navigator TUI. The environment variable ANSIBLE_NAVIGATOR_CONFIG can point to a settings file.

from ansible_navigator.app import AnsibleNavigator import os os.environ['ANSIBLE_NAVIGATOR_CONFIG'] = '' # optional, set to empty string for default navigator = AnsibleNavigator() navigator.run()

ansible-navigator --version

Debug

Known issues

breakingVersion 2.x (ansible-navigator) changed CLI options significantly from 1.x (ansible-tui). Many flags were renamed or removed.

fix

Update to 2.x or later and refer to current documentation for CLI syntax.

affects: <=1.x

deprecatedThe '--playbook-artifact' option has been deprecated in favor of '--artifact-format' and '--artifact-dir'.

fix

Use '--artifact-format' and '--artifact-dir' instead.

affects: >=24.0.0

gotchaIf running in a headless environment without a proper terminal (e.g., CI/CD), the TUI will fail. Use '--mode stdout' or set the environment variable ANSIBLE_NAVIGATOR_MODE=stdout.

fix

Set ANSIBLE_NAVIGATOR_MODE=stdout or pass --mode stdout to run without TUI.

affects: all

gotchaThe import path changed from 'ansible_navigator' to nested modules. Common top-level imports fail silently.

fix

Use correct imports like 'from ansible_navigator.app import AnsibleNavigator'.

affects: >=2.0.0

gotchaPython 3.10+ is required. Installations on older Python versions will fail.

fix

Upgrade to Python 3.10 or later.

affects: >=26.0.0

Upgrade

Version history

26.4.0latest on PyPI · released Apr 6, 2026

Audit

Dependencies

ansible-corerequiredRuntime dependency for executing playbooks

cursesoptionalTUI interface; may need manual install on some platforms

Agent activity

33 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/ansible/ansible-navigator ↗

packagehttps://pypi.org/project/ansible-navigator/ ↗

homepagehttps://access.redhat.com/products/red-hat-ansible-automation-platform ↗

docshttps://ansible-navigator.readthedocs.io/en/latest/ ↗

changeloghttps://github.com/ansible/ansible-navigator/releases ↗