pyinfra-dev / pyinfra

pyinfra turns Python code into shell commands and runs them on your servers. Execute ad-hoc commands and write declarative operations. Target SSH servers, local machine and Docker containers. Fast and scales from one server to thousands. Think ansible but Python instead of YAML, and a lot faster. --- Getting Started • Examples Repo • Chat on Matrix Documentation • Help & Support • Contributing --- Why pyinfra? Design features include: • 🚀 **Super fast** execution over thousands of hosts with predictable performance. • 🚨 **Instant debugging** with realtime stdin/stdout/stderr output ( ). • 🔄 **Idempotent operations** that enable diffs and dry runs before making changes. • 📦 **Extendable** with the entire Python package ecosystem. • 💻 **Agentless execution** against anything with shell access. • 🔌 **Integrated** with connectors for Docker, Terraform, Vagrant and more. Quickstart Install pyinfra with : Now you can execute commands on hosts via SSH: Or target Docker containers, the local machine, and other connectors: As well as executing commands you can define state using operations: Which can then be saved as a Python file like : The hosts can also be saved in a file, for example : And executed together: Now you know the building blocks of pyinfra! By combining inventory, operations and Python code you can deploy anything. See the more detailed getting started or using operations guides. See how to use inventory & data, global arguments and the CLI or check out the documented examples. ---