garnix-io/garnix-ci

Garnix is a continuous integration (CI) service built specifically for GitHub repositories that use Nix flakes. Nix is a package manager and build system that describes software environments in a very precise, reproducible way. A "flake" is a specific format for Nix projects that makes them easier to share and build consistently across machines. Garnix reads these flake definitions and automatically builds and tests the code whenever changes are pushed. The project is written in Haskell and is now open source. In addition to running CI builds, Garnix also handles hosting, meaning it can serve the outputs of successful builds, not just verify that they pass. For developers who want to run Garnix locally or contribute to it, the README explains how to spin up virtual machines on their computer using a tool called qemu. A helper command sets up a small simulated Garnix deployment that includes a web interface for monitoring builds and an admin panel for development tasks. Setting up a working instance also requires creating a GitHub App, which is how Garnix authenticates with GitHub to receive notifications about new commits and report build results back to pull requests. The README walks through that setup process and shows how to submit a test build via a command-line request. Frontend development is also documented: you can run the web interface in a live-reload development mode while the backend runs inside a virtual machine. The acknowledgments section notes that git history was cleared when the project was open-sourced, and lists the contributors who worked on it before that point.