Index

index builds ready-to-run VM images from NixOS modules. Every image targets x86_64 Linux and ships as an OCI archive.

Use it for runnable images and reusable service modules.

Quick Check

nix build .#minecraft
nix run .#lint

The first image build may be slow while Nix realizes the image closure. Later rebuilds reuse cached store paths from the local Nix store and configured substituters.

What Is Here

• images/ contains runnable systems.
• modules/ contains opt-in NixOS service modules.
• examples/ contains standalone consumer fleets, including a daily Python scraper.
• packages/ contains repo-owned tools such as llm-clippy.
• lib/ contains the shared helper API used by the repo and consumers.

Bad Fit If

You need aarch64 images, FreeBSD, or a sealed appliance with almost no operator tooling. This repo is tuned for ix VM workflows on x86_64 Linux.

Feedback

Bug reports and enhancement requests go to GitHub Issues. Security reports follow SECURITY.md. Code changes land through pull requests against the main branch; see CONTRIBUTING.md for local setup, coding standards, and commit conventions.

Contributor Notes

See AGENTS.md and CONTRIBUTING.md when you're ready to dig in.