What is hearth
hearth is a declarative NixOS configuration for running local language models and
autonomous agents on hardware you control. The entire operating system is defined
in one flake.nix that Nix builds reproducibly and deploys to any NixOS host or
Proxmox VM.
What it is not
hearth is not a custom Linux kernel and not a remastered distro. There is no ISO to flash with a bespoke userland. It is a single flake that configures stock NixOS, which means you get reproducibility and atomic rollback for free.
Why it exists
Most people running local agents are flying blind: agents run with full system privileges and leave no record of what they did. hearth makes agent activity legible and contained at the operating-system level.
- Contained. Every agent run is sandboxed with systemd isolation primitives.
- Legible. Every run records its token count, cost, latency, and errors to a local SQLite database.
- Reproducible. The flake lock pins every input, so two builds produce the same system.
Who it is for
People running local LLMs and agents on a homelab, a workstation, or a VM who want least-privilege isolation and a real audit trail instead of trust by default.
Next steps
- Quickstart to validate the flake.
- Choose your install path.
- Architecture for the system design and module map.