pyinfra

Deploy to servers

$ pyinfra [inventory] [deploy.py]

$ pyinfra [inventory] exec -- [command]

$ pyinfra --dry [inventory] [deploy.py]

$ pyinfra [inventory] fact [server.Hostname]

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.

Execute command.

Get server facts.

Verbose 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)