f1622fae84606bd3e248d5928b0bd90ec1661e0e
Hermenix
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 |
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
Languages
Nix
64.4%
Nushell
35.2%
Nu
0.4%