manic-systems

manic-systems / circus

Public

Declarative Nix CI system for clowns

19
1
89% credibility
Found May 28, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Circus is an open-source continuous integration system designed for Nix-based projects that automatically monitors git repositories, evaluates build configurations, orchestrates distributed builds across multiple machines, and serves the resulting artifacts through a built-in binary cache.

How It Works

1
🔧 Set up your CI system

You install Circus and connect it to a database, configuring your first projects and build jobs through simple configuration files.

2
📦 Define what to build

You create jobsets that tell Circus which parts of your Nix project to build, like tests, packages, or release artifacts.

3
🔄 Automatic checking begins

Circus watches your git repositories and automatically checks whenever new code is pushed, without you lifting a finger.

4
⚙️ Builds run automatically

When changes are detected, Circus evaluates your Nix expressions and starts building, distributing work across multiple machines if needed.

5
Results are shared
💬
GitHub/GitLab status

Commit statuses update automatically on your pull requests

📱
Slack alerts

Your team gets instant notifications when builds succeed or fail

📧
Email digest

Summary emails keep everyone informed on their own schedule

6
🚀 Releases are packaged

Successful builds become available through release channels, making it easy to distribute your software to users.

✅ Everything runs smoothly

Your project builds automatically, your team stays informed, and your users get reliable, reproducible software.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is circus?

Circus is a self-hosted CI system built in Rust for Nix and NixOS projects. It evaluates flake repositories, schedules builds across multiple machines, and serves a web dashboard for monitoring pipelines. Think of it as a Hydra replacement that embraces the declarative Nix ecosystem -- you define projects, jobsets, and notifications in a simple config file, and Circus handles the rest.

Why is it gaining traction?

The declarative configuration model is the hook. Instead of clicking through a UI or writing YAML pipelines, you define everything in a single TOML file that gets upserted on startup. This makes it trivial to version-control your entire CI setup alongside your code. The system also supports remote builders for distributed builds, multiple notification backends (GitHub, GitLab, Gitea, Slack, email), and integrates directly with the Nix store for binary caching. For teams already invested in Nix flakes, this feels like the natural way to run CI.

Who should use this?

NixOS maintainers and projects with complex flake-based builds will get the most value. If you're tired of Hydra's maintenance burden or want something that understands Nix natively, Circus is worth evaluating. Small teams running multiple architectures or needing distributed builds will appreciate the remote builder support. It's probably not for projects that just want GitHub Actions with minimal config.

Verdict

Circus is a well-architected system with solid fundamentals (Rust, PostgreSQL, async I/O), but the 0.8999999761581421% credibility score and low star count signal early-stage software. The codebase shows good engineering practices, but documentation and community are minimal. Try it if you need deep Nix integration; stick with established CI for anything requiring stability guarantees.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.