pym2 is a lightweight Linux-first process manager for Python services.

It is similar to PM2, but designed as a small single binary with minimal dependencies and a clean agent-based architecture.

Ideal for:

• FastAPI
• Django
• background workers
• Python APIs
• small self-hosted services

Many Python services end up managed by either:

• raw systemd units
• heavy orchestrators
• Node-based process managers

pym2 focuses on a simpler model.

Start the agent:

pym2 agent

Add an application:

pym2 add-fastapi --name api --cwd /srv/api --entry app:app

Start it:

pym2 start api
pym2 status

[[apps]]
name = "api"
cwd = "/srv/api"

command = [
  "python",
  "-m",
  "uvicorn",
  "app.main:app",
  "--host","0.0.0.0",
  "--port","8000"
]

env_file = "/srv/api/.env"
restart = "on-failure"
autostart = true

Lifecycle:

pym2 start <app>
pym2 stop <app>
pym2 restart <app>
pym2 status
pym2 inspect <app>

Logs:

pym2 logs <app> -f
pym2 events --follow

Diagnostics:

pym2 ping
pym2 doctor
pym2 config lint

Interactive mode:

pym2 tui

Enable in config:

[agent.web]
enabled = true
host = "127.0.0.1"
port = 17877
password = "change-me"

Security rules:

• localhost by default
• public bind requires password
• recommended behind reverse proxy + TLS

pym2 protects services from restart storms.

Defaults:

If exceeded:

status: Errored reason: max_restarts_exceeded

Minimal build:

cargo build --release

With TUI:

cargo build --release --features tui

With Web UI:

cargo build --release --features webui

Manual:

sudo install -m755 pym2 /usr/bin/pym2

Systemd:

sudo cp systemd/pym2.service /etc/systemd/system/ sudo systemctl daemon-reload sudo systemctl enable --now pym2

Debian:

./scripts/build-deb.sh --arch amd64

RPM:

./scripts/build-rpm.sh --arch x86_64

High level:

CLI │ │ IPC (Unix socket) ▼ Agent │ ▼ Supervisor │ ▼ Managed Processes

See:

docs/ARCHITECTURE.md docs/DEV_RULES.md

AGPL-3.0-or-later