index

Index

index builds ready-to-run VM images from NixOS modules. Every image targets AMD EPYC Gen 5 (znver5) 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 is slow because the full closure compiles from source for znver5. Later rebuilds reuse the local Nix store.

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 generic x86_64 binaries, aarch64 images, or FreeBSD. This repo chooses -march=znver5 for the whole closure, so generic nixpkgs cache hits are intentionally out of scope.

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.

This site is open source. Improve this page.