Muster is a catalog of reusable operational shapes for small Linux appliances, especially systemd-based edge machines.
The repository is organized around pattern contracts rather than loose unit-file snippets. Each pattern has a stable ID, manifest, README, example artifacts, and validation rules.
schemas/ JSON Schema for pattern manifests
templates/ Copyable pattern authoring templates
patterns/ Tech I, II, and III pattern folders
examples/ Concrete appliance sketches
tools/ Validation and documentation renderers
docs/ Taxonomy, authoring guide, generated index, graph
tests/ Repository-level validation tests
Use UV for Python commands:
uv run python tools/validate_patterns.py
uv run python tools/check_composition_rules.py
uv run python tools/check_production_beta.py
uv run python tools/check_stable_tech1.py
uv run python tools/render_index.py --check
uv run python tools/render_graph.py --check
uv run python tools/render_completion.py --check
uv run python -m unittest discover testsThe first milestone is a complete, machine-checkable scaffold for the planned Muster pattern catalog:
- Tech I Common, Rare, and Mythic patterns
- Tech II Common and Rare patterns
- Tech III Common, Rare, and Mythic patterns
- Example appliance sketches for edge bundles, Bluetooth audio, DVD ripping, and G-code spooling
docs/index.md and docs/pattern-graph.md are generated from manifests. Do not hand-edit them.
docs/completion.md is also generated and reports maturity from manifest status fields.
T2R4.device-triggered-conveyor is the first production-beta rare pattern for device-event ingest appliances. C6.lifecycle-capsule and T2R5.signed-update-rail capture the core install, doctor, update, rollback, and clean-uninstall lifecycle. T2R6.home-assistant-mqtt-bridge adds a mockable Home Assistant MQTT discovery, state, and control bridge.