pyinfra-dev/pyinfra

Pyinfra is a Python tool for automating server configuration and deployment tasks. Instead of writing configuration files in a special format or learning a new language, you write plain Python scripts that describe what your servers should look like. Pyinfra then translates those Python instructions into the actual shell commands needed to make each server match your specifications. The tool connects to servers over SSH by default, so you do not need to install any agent software on the machines you are managing. It also works on your local machine and inside Docker containers, which makes it possible to test infrastructure changes in a safe environment before applying them to production servers. Pyinfra supports two main workflows. In the first, you can run ad-hoc commands across many servers at once, similar to running a shell command on one machine but doing it on dozens or hundreds at the same time. In the second, you write declarative operation files that describe the desired state of your servers: which packages should be installed, which files should exist, which services should be running. Pyinfra figures out the steps needed to reach that state and runs them. The project is described as high performance and built to scale from a single server up to thousands. Because it uses Python, you can bring in the full Python ecosystem to add logic to your infrastructure code, such as loops, conditionals, reading configuration from files, or connecting to external APIs. No README is included in the repository root, so this description is based on the project metadata. The official documentation and usage examples live on the project's external documentation site.