simpervisor

What it is and what it does

simpervisor wraps subprocess management into an async-friendly API, offering a SupervisedProcess class with async methods for the full lifecycle of a child process: start, ready, terminate, and kill. It is designed for applications that need to spawn and manage external processes from within async code without blocking the event loop.

The package has no runtime dependencies and works with Python 3.8 through 3.11 on both CPython and PyPy. It is actively maintained and used by JupyterHub's jupyter-server-proxy to manage proxy processes. The low install friction and permissive BSD license make it straightforward to integrate into projects that need lightweight async process supervision.

Use it for:

• Start and manage proxy or gateway processes from within a JupyterHub-like async application.
• Supervise background worker processes in an async web service without blocking the event loop.
• Implement graceful shutdown of child processes in an async application by calling terminate or kill.
• Coordinate multiple managed subprocesses in a microservice or orchestration context.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides async methods to start, manage, and terminate child processes through a SupervisedProcess class.

Yes. Low install friction, no dependencies, active maintenance, and a permissive license make this a safe choice for any async Python project that needs to spawn and manage child processes. The narrow scope and stable API reduce risk; use it if you need async process lifecycle control.

Install

simpervisor on PyPI

pip install simpervisor

uv add simpervisor

poetry add simpervisor

Installing simpervisor

Before you install

Low friction installation with no runtime dependencies. Actively maintained as of August 2026, with consistent Python version support across 3.8–3.11 and PyPy.

License in practice

BSD 3-Clause License permits commercial and private use with minimal restrictions; you must retain copyright notices and disclaimers in source and binary distributions.

Quickstart

pip install simpervisor

import asyncio
from simpervisor import SupervisedProcess

async def main():
    proc = SupervisedProcess("sleep", "10")
    await proc.start()
    await proc.terminate()

asyncio.run(main())

Requires Python 3.8 or later; async/await syntax required in calling code.

Verify before relying

• Whether SupervisedProcess supports stdin/stdout/stderr capture or streaming.
• Whether the package handles process groups or only individual processes.
• What happens to child processes if the parent asyncio event loop exits unexpectedly.

Package facts

Evidence: simpervisor-1.0.0-py3-none-any.whl

Keywords: async, process, supervisor

Tags

More Monitoring packages