pyinfra

pyinfra [options] inventory operations

pyinfra automates infrastructure provisioning and configuration management using Python. Deploy scripts are written as regular Python files that describe desired system state through operations like installing packages, managing files, configuring services, and executing commands across groups of servers.The tool connects to targets over SSH without requiring agents on remote machines, making it lightweight to adopt. An inventory file defines target hosts and groups, while deploy scripts specify what operations to run. The --dry flag previews changes before applying them, and the fact command gathers system information from targets for conditional logic in deployments.

INVENTORY

Target hosts file.

Deploy script or commands.

Dry run mode; print operations without executing.

Filter execution to specific hosts by name or glob pattern.

Retry failed operations up to N times.

Print inventory hosts, groups, and data.

Show facts after generating operations and exit.

Show operations after generating and exit.

Execute an arbitrary shell command on hosts.

Gather facts from target hosts.

Increase verbosity (facts, shell input, shell output).

inventory.py

Default inventory file defining target hosts, groups, and connection details for deployments.

Default deploy script containing operations to execute on target hosts.

Group-specific data files providing variables for host groups defined in the inventory.

Project-level configuration for SSH settings, sudo behavior, and operation defaults.

Python required. SSH-based deployment.

pyinfra was created for Python-based infrastructure automation.

ansible(1), fabric(1), salt(1)