quadlet-compose

A Python-native compose→quadlet compiler that acts as a drop-in replacement for docker-compose / podman-compose. It parses compose.yaml files using PyYAML and auto-generated Pydantic models from the compose-spec JSON Schema, translates them into Podman Quadlet unit files via a declarative mapping layer, and manages the resulting systemd services via systemctl.

Status: Early alpha. Core compose→quadlet translation is functional. Most common commands are implemented. Not recommended for production use.

Quick Start

Install latest release from PyPi (recommended)

pip install quadlet-compose

See Installation for more installation options.

Requirements

• podman — container runtime
• Python 3.10+
• PyYAML — YAML parsing
• pydantic — compose-spec model validation
• rich — terminal output

Documentation

• Installation — Pip, PyInstaller binary, Nix, and podman compose provider setup
• Usage — CLI commands and options
• Command Compatibility — docker compose command support matrix
• Variable Interpolation — .env file loading and $VAR substitution syntax
• Field Compatibility — Compose→Quadlet field mapping tables (services, builds, networks, volumes)

License

Apache License 2.0