Skip to main content

AsyncIO-powered python DSL for running tasks locally, on docker, or over ssh.

Project description

🔧 Pitcrew

AsyncIO-powered python DSL for running tasks locally, on docker, or over ssh.


At a glance

Pitcrew makes it easy to run commands on one or a lot of machines.

Get the time on 100 machines at once

crew sh -p providers.ssh -P '{"user": "root", "hosts": [""]}' date

Install Homebrew on a Mac

crew run install.homebrew

Host a website using S3, CloudFront & SSL

crew run examples.deploy_pitcrew


From binary

To install pitcrew in your home directory, run the following:

curl -fsSL "$(uname)" > crew
chmod u+x crew
./crew run crew.install --dest="$HOME/crew"

From PyPi

To install from the Python Package Index, run the following:

pip install pitcrew
crew run crew.install --dest="$HOME/crew"

From source

git clone
cd pitcrew
python3.6 -m venv env
env/bin/pip installer -r requirements.txt


A command or set of commands is called a task. A context runs tasks either locally, on docker or over ssh. A provider generates contexts.


Tasks are either composed from other tasks or invoking a command on a shell.

An example of a task might be reading a file. reads a file as bytes and returns it:


import base64
from pitcrew import task

@task.arg("path", desc="The file to read", type=str)
@task.returns("The bytes of the file")
class FsRead(task.BaseTask):
    """Read value of path into bytes"""

    async def run(self) -> bytes:
        code, out, err = await self.sh_with_code(f"cat {self.params.esc_path}")
        assert code == 0, "exitcode was not zero"
        return out

Other tasks might include writing a file, installing xcode or cloning a git repository. All the currently available tasks are listed at docs/ The api available in a task is available at docs/


An example of a context might be over ssh, or even locally. Learn more about contexts at docs/


A provider is a task with a specific return type. The return type is an async iterator which returns contexts.


For detailed usage, see docs/ for more details.

Run a command

Pitcrew allows running a command using bin/crew sh -- [shell command].

For example crew sh ls / will list the "/" directory locally.

You can run this across three hosts via ssh using crew sh -p providers.ssh -P '{"hosts": ["", "", ""]}' ls /.

Run a task

Pitcrew allows running a task using crew run [task name] <task args>. This will normally target your local machine unless you use the -p flag to select a different provider.

See available tasks

To see all the available tasks run crew list. This will show all available tasks which are stored in crew/tasks.

Make a new task

To see all the available tasks run crew new [task_name]. This will create a template of a new task.

Run tests

To run an ad-hoc command use . For tasks use crew run [task-name] <args>.

Get CLI help

To see the whole list of commands available from the command-line, run crew help.

Project details

Download files

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

Files for pitcrew, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size pitcrew-0.0.1-py2.py3-none-any.whl (26.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size pitcrew-0.0.1.tar.gz (17.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page