Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

PyPI version PyPi downloads Docs status Execute tests 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 hosts with predictable performance.
  • 🚨 Instant debugging with stdout & stderr output on error or as required (-v|-vv|-vvv).
  • 📦 Extendable with any Python package as configured & written in standard Python.
  • 💻 Agentless execution against SSH/Docker/subprocess/winrm hosts.
  • ❗️ Two stage process that enables --dry runs before executing any changes.
  • 🔌 Integrated with Docker, Vagrant/Mech & Ansible out of the box.

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

Quickstart

pyinfra can be installed via pip:

pip install pyinfra

Now you can execute commands & operations over SSH:

# Execute an arbitrary shell command
pyinfra my-server.net exec -- echo "hello world"

# Install iftop apt package if not present
pyinfra my-server.net apt.packages iftop sudo=true update=true

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

from pyinfra.operations import apt

apt.packages(
    name='Ensure iftop is installed',
    packages=['iftop'],
    sudo=True,
    update=True,
)

And executed with:

pyinfra my-server.net deploy.py

or

pyinfra @docker/ubuntu deploy.py

Documentation

Download files

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

Source Distribution

pyinfra-1.5.0.dev4.tar.gz (180.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyinfra-1.5.0.dev4-py2.py3-none-any.whl (226.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file pyinfra-1.5.0.dev4.tar.gz.

File metadata

  • Download URL: pyinfra-1.5.0.dev4.tar.gz
  • Upload date:
  • Size: 180.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.4

File hashes

Hashes for pyinfra-1.5.0.dev4.tar.gz
Algorithm Hash digest
SHA256 c7133553b96e5159cb7bf7b165dc0d02a2bee639a8f004e2dcf9514d876bd98f
MD5 bf46d6ee9a043b7d4debb07c64c0ff2e
BLAKE2b-256 0e3cf5eca1d8365c2b09641596b8e0f8385a3fd4f80eb50f089a708c1b2bccb8

See more details on using hashes here.

File details

Details for the file pyinfra-1.5.0.dev4-py2.py3-none-any.whl.

File metadata

  • Download URL: pyinfra-1.5.0.dev4-py2.py3-none-any.whl
  • Upload date:
  • Size: 226.3 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.4

File hashes

Hashes for pyinfra-1.5.0.dev4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4cc83aad8847ef0e2e356e44ae26ad7e42697871c4475a967d00a9cdb76dfd39
MD5 b6fdb87f1fcf3d211cd74cdf81bbe746
BLAKE2b-256 3d149af63b231f330883c5d1439582f75ea13f420b95924b20f74809f437413b

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

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