Skip to main content

WARP: Wrapper around Replicated Processes

Project description

WARP: Wrapper around Replicated Processes

WARP is a light-weight manager for background processes.


  • Easily spawn any process as a managed subprocess
  • Automatic recover from failed process
  • Runs completely async
  • Cleanly exits in a safe order (subprocess, WARP manager, then main process)


So you need to run a subprocess in the background of your Python application. How do you do it?

  • If you simply start the process in an async way, how can you ensure that the process can is restarted if it exits?
  • If you start the process in a synchronous way, how do you ensure that the rest of your program continues to execute?
  • If you use supervisord, how do you ensure that all your users have supervisord installed ahead of time?
  • If you use celery or some kind of heavy weight solution, you now need standalone infra and need to manage a lot of complexity

WARP makes it very simple to manage a background process in a self-healing way. The subprocess runs in a background thread that continually monitors the health of the subprocess. WARP is also able to intelligently support interrupt signals.


pip install warp


Import WARP

from warp import Warp

Create a WARP object

wp = Warp(command="")

Start the WARP process


The process will automatically be killed (cleanly) when the main process exits

Alternatively you may also forcefully stop this background process



Run the following command from the repo root


Python Compatibility

WARP only supports the following Python versions

  • 3.7
  • 3.8
  • 3.9


WARP is a community project. Feel free to submit a PR and/or an issue if you are looking for more functionality or found a bug!

Project details

Download files

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

Source Distribution

warp-1.0.4.tar.gz (6.1 kB view hashes)

Uploaded source

Built Distribution

warp-1.0.4-py3-none-any.whl (6.1 kB view hashes)

Uploaded py3

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