2026-10-10 22:56:24 -04:00
2026-10-09 11:20:32 -04:00
2026-10-09 14:35:12 -04:00
2026-10-10 22:06:12 -04:00
2026-10-09 14:35:12 -04:00
2026-10-10 22:56:24 -04:00
2026-10-09 14:35:12 -04:00
2026-10-09 14:35:12 -04:00
2026-09-17 15:16:29 -04:00
2026-09-23 13:24:07 -04:00
2026-10-09 14:35:12 -04:00
2026-09-16 22:09:42 -04:00
2026-09-17 15:16:29 -04:00
2026-10-09 14:35:12 -04:00
2026-09-17 14:14:14 -04:00
2026-10-09 14:35:12 -04:00
2026-10-09 14:35:12 -04:00
2026-10-09 14:35:12 -04:00

Hermenix

Logo

Hermes Agent in a NixOS VM that owns its own bootloader and /nix/store, on two btrfs-backed disks, under an unprivileged hardened QEMU.

THE ULTIMATE WAY TO RUN HERMES!

The agent can rebuild its own system and update itself, durably. It shares no filesystem with the host, and reaches nothing on your network unless you say so.

Hermes product behavior (CLI, providers, gateway, skills, memory) lives in upstream Hermes docs — this repo documents the VM, host module, and hermenix CLI around it.

Quickstart

nix run git+ssh://gitea@gitea.skyg.ca/ari/hermenix.git#hermenix -- setup

Paste the printed module snippet into your host flake, then:

sudo nixos-rebuild switch
hermenix vm console
hermenix vm ssh              # labels, determinate-nixd login, flake lock — see install doc

Full path: docs/INSTALL.md.

CLI

For
hermenix setup host provisioning
hermenix migrate <src> existing HERMES_HOME → guest
hermenix migrate connections connection files only
hermenix remote <host> "<cmd>" setup/migrate over SSH
hermenix vm <sub> VM lifecycle, snapshots, backups
hermenix ctl <sub> host bridge into guest files / unit / hermes
hermenix version package version

docs/CLI.md.

Documentation

Doc Contents
docs/CONCEPTS.md disks, boundary, seed-once, vsock, Determinate Nix
docs/INSTALL.md guided setup, module, first boot, remote
docs/MANUAL_SETUP.md hand-run setup
docs/CLI.md vm / ctl
docs/NETWORK.md NAT vs bridged, allowlists
docs/PASSTHROUGH.md PCI/USB, virtual devices
docs/RECOVERY.md generations, snapshots, backups, --clean
docs/MIGRATE.md carry over an existing home
docs/DEVELOP.md devenv, tests
docs/ROUGH_EDGES.md known issues
GUIDELINES.md coding-agent rules for this repo
Hermes Agent upstream product docs

Boundary (short)

Default
Public internet yes
Host Nix cache yes (one port)
Host / LAN / inbound deny, unless allowlisted
Host hardware none, unless passthrough

docs/NETWORK.md · docs/CONCEPTS.md

Hacking

direnv allow
runtest
runvmtest

Agents: builds only via bin/runtest / bin/runvmtest (-debug ok). GUIDELINES.md · docs/DEVELOP.md

S
Description
Hermes + NixOs Opinionated Setup
Readme
774 KiB
0 Stars 1 Watchers 0 Forks
Languages
Nix 64.4%
Nushell 35.2%
Nu 0.4%