Templates
These are small projects for you to copy and grow. The examples in these docs show one idea each; a template is a whole project. Each one here is evaluated in our CI.
| Template | What it is | Start |
|---|---|---|
agent-containers |
Claude Code in NixOS containers: each with its own tools and ~/.claude, all sharing one login | nix flake init -t github:vic/yen#agent-containers |
agent-swarm |
A swarm of agents on one OpenAI-compatible endpoint: each a model, a prompt and a schedule | nix flake init -t github:vic/yen#agent-swarm |
basic-fleet |
A fleet: environments, their hosts, macs and homes, users, dev shells, deploy-rs | nix flake init -t github:vic/yen#basic-fleet |
flake-parts |
One NixOS host inside flake-parts, next to its perSystem outputs | nix flake init -t github:vic/yen#flake-parts |
k8s-services |
Kubernetes services as data: Helm charts and your own apps, scraped by Prometheus, shown in Grafana | nix flake init -t github:vic/yen#k8s-services |
kits-base |
yen: machines from the library bundle base (disk, hardware report, ssh, break-glass login) | nix flake init -t github:vic/yen#kits-base |
kits-homelab |
yen: a homelab fleet from the library kits (base, wireguard, borg, monitoring, dns) | nix flake init -t github:vic/yen#kits-homelab |
minimal |
One NixOS host | nix flake init -t github:vic/yen#minimal |
multi-platform |
NixOS, nix-darwin and home-manager hosts in one fleet | nix flake init -t github:vic/yen#multi-platform |
neovim |
Neovim variants with nvf: one theme and language set each, and a neovide GUI for each | nix flake init -t github:vic/yen#neovim |
noflake |
One NixOS host, without flakes | `curl -L https://github.com/vic/yen/archive/main.tar.gz |
Not sure which one? Take minimal. Getting started is the same host with a step-by-step page.
noflake needs no flake: Project layout explains both entry points.
reference is the showcase template. Read it, but do not start from it: its yen input is this repository.
New to the words in the table? Read the overview and the glossary.