---
id: simpervisor
version: "1.0.0"
license: BSD 3-Clause License Copyright (c) 2018, Yuvi Panda All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# simpervisor — Simple async process supervisor

License: permissive · Maintenance: active · Downloads: 643.6K/mo

## 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 above — 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

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

- License: BSD 3-Clause License Copyright (c) 2018, Yuvi Panda All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 643.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

async process management, supervised process control, child process lifecycle, async subprocess supervisor, process start stop terminate, async process orchestration, async-subprocess, process-lifecycle

[View on SkillFed](https://skillfed.io/packages/simpervisor) · [View on PyPI](https://pypi.org/project/simpervisor/)