Skip to main content

pyinfra automates/provisions/manages/deploys infrastructure.

Project description

PyPI version Docs status Travis.CI status Codecov Coverage MIT Licensed

pyinfra automates/provisions/manages/deploys infrastructure super fast at massive scale. It can be used for ad-hoc command execution, service deployment, configuration management and more. Core design features include:

  • 🚀 Super fast execution over thousands of targets with predictable performance.
  • 🚨 Instant debugging with stdout + stderr output on error, and -v to print it always.
  • 💻 Agentless execution by speaking native SSH/Docker/subprocess depending on the target.
  • ❗️ Two stage process that enables --dry runs before making any changes.
  • 📦 Extendable with any Python package as configured & written in standard Python.
  • 🔌 Integrated with Docker, Vagrant/Mech & Ansible out of the box.

When you run pyinfra you'll see something like (non animated version):


pyinfra can be installed via pip:

pip install pyinfra

Now you can execute commands & operations over SSH:

# Execute an abitrary shell command
pyinfra exec -- echo "hello world"

# Install iftop apt package if not present
pyinfra apt.packages iftop sudo=true update=true

These can then be saved to a deploy file, let's call it

from pyinfra.modules import apt

    {'Install iftop'},

And executed with:



pyinfra @docker/ubuntu


Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyinfra-0.13.tar.gz (127.8 kB view hashes)

Uploaded Source

Built Distribution

pyinfra-0.13-py2.py3-none-any.whl (155.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page