This release is a pre-release and may not be stable for production use.
Note: this is the v3 branch, which is currently in beta. See the docs for v3. If needed the 2.x branch is here, but is in bugfix only mode.
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 (
-vvv). - 🔄 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 pip:
pip install pyinfra
Now you can execute commands on hosts via SSH:
pyinfra my-server.net exec -- echo "hello world"
Or target Docker containers, the local machine, and other connectors:
pyinfra @docker/ubuntu exec -- echo "Hello world"
pyinfra @local exec -- echo "Hello world"
As well as executing commands you can define state using operations:
# Install iftop apt package if not present
pyinfra @docker/ubuntu apt.packages iftop update=true _sudo=true
Which can then be saved as a Python file like deploy.py:
from pyinfra.operations import apt
apt.packages(
name="Ensure iftop is installed",
packages=['iftop'],
update=True,
_sudo=True,
)
The hosts can also be saved in a file, for example inventory.py:
targets = ["@docker/ubuntu", "my-test-server.net"]
And executed together:
pyinfra inventory.py deploy.py
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyinfra-3.0b4.tar.gz.
File metadata
- Download URL: pyinfra-3.0b4.tar.gz
- Upload date:
- Size: 191.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f192bc65e754f14e1772d33cb9dbba8fcd3e4af9ec2ba8c0e4ef00c515e28a7c
|
|
| MD5 |
da58b5b07ccbd47c4f11455d385e9b66
|
|
| BLAKE2b-256 |
10809fbd5b9ece8b4a31a2e6919c9b6f8ab4b7d22ecb276901a35b02d207feea
|
File details
Details for the file pyinfra-3.0b4-py2.py3-none-any.whl.
File metadata
- Download URL: pyinfra-3.0b4-py2.py3-none-any.whl
- Upload date:
- Size: 249.2 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3cefcc826e120919e238660ab97c239948f5470d8463ae97b1d6cc4844165ebb
|
|
| MD5 |
dae6d64f52d83076a55ae9c81ef95351
|
|
| BLAKE2b-256 |
01f780ccd72fb0885b03b83ec8febb91350b8835961d3b9862ea26671a87f475
|
