Pip + SQLite
pip install z4j, then z4j serve. Zero containers, zero infra.
The lightest deployment tier: a single PyPI install with SQLite as the data store. No Postgres, no Docker daemon, no Kubernetes. Right for a homelab Raspberry Pi, a single-developer laptop, a CI worker, or a small team. It serves the same dashboard, RBAC model, and audit surface as the production tiers, while storage, coordination, and scaling behavior remain backend-specific.
Ships with
- Pure Python install via pip; no Docker daemon required
- SQLite by default; Postgres is a separate installation with no built-in data transfer
- First-boot setup wizard mints secrets and writes them to ~/.z4j/secret.env
- 127.0.0.1 default bind keeps dev installs off the network
- Same dashboard and API surface as the Docker tiers, with backend-specific storage and scaling behavior
Highlights
- Single-package install on a supported machine with Python 3.11+
- Smart buffer-path fallback for service-user installs (gunicorn under www-data)
- Framework agent doctor commands run the DNS, TCP, TLS, and WebSocket connectivity ladder; brain z4j doctor checks local configuration and dependencies
Related