systemg

Search docs

/
Install

v0.65.0 is out

read the release notes

Run your whole stack from one file.

systemg is an agent-friendly process composer. Services start in dependency order, restart with backoff, and log to one stream — from a single YAML file, with no daemon to install alongside it.

Get startedRead the docs →
$ curl --proto '=https' -fsSL https://sh.sysg.dev/ | sh

supervise

Dependency-ordered startup

Independent branches start in parallel; dependents wait on a health check, not a sleep.

recover

Restart with backoff

Unsuccessful exits retry on a doubling delay and reset once the process stays healthy.

observe

One prefixed log stream

Every service writes to the same stream, so ordering across processes is preserved.

One file describes the graph

Declare commands, dependencies, restart policy and schedules in one manifest. sysg validate exits 0 when the file is sound, so CI can gate on it.

sysg

0.41 s

docker compose

2.30 s

supervisord

2.95 s

Illustrative — not a measured benchmark. Cold start of an eleven-service graph, Linux x64, median of 5 runs. Replace with real figures before publishing.

sysg.yaml
version: "2"
services:
postgres:
command: "postgres -D /var/lib/postgresql/data"
api:
command: "python app.py"
depends_on: ["postgres"]
restart: { backoff: 1s, max: 5 }
backup:
command: "pg_dump mydb > /backups/db.sql"
cron: "0 2 * * *"

Start with the quickstart

One binary, one file, five minutes.