Hermes & Sam
fc4b57adeb
Some checks failed
Lint (ruff + ty) / Windows footguns (blocking) (push) Has been cancelled
Typecheck / typecheck (ui-tui) (push) Has been cancelled
Typecheck / typecheck (web) (push) Has been cancelled
Lint (ruff + ty) / ruff enforcement (blocking) (push) Has been cancelled
Nix / nix (macos-latest) (push) Has been cancelled
Nix / nix (ubuntu-latest) (push) Has been cancelled
Tests / test (1) (push) Has been cancelled
Tests / test (2) (push) Has been cancelled
Tests / test (3) (push) Has been cancelled
Tests / e2e (push) Has been cancelled
Typecheck / typecheck (apps/bootstrap-installer) (push) Has been cancelled
Typecheck / typecheck (apps/desktop) (push) Has been cancelled
Typecheck / typecheck (apps/shared) (push) Has been cancelled
Lint (ruff + ty) / ruff + ty diff (push) Has been cancelled
Tests / test (4) (push) Has been cancelled
Tests / test (5) (push) Has been cancelled
Tests / test (6) (push) Has been cancelled
Tests / save-durations (push) Has been cancelled
Co-authored-by: Hermes & Sam <hello@clawdie.si> Co-committed-by: Hermes & Sam <hello@clawdie.si>
1.6 KiB
1.6 KiB
Hermes Agent — FreeBSD
This is a clean-room FreeBSD compatibility layer for Hermes Agent, built from the MIT-licensed upstream. No LGPL code, no Autolycus dependency.
What's patched
Three targeted changes for FreeBSD native support:
| File | Change |
|---|---|
hermes_cli/setup.py |
FreeBSD in platform detection, pkg for espeak-ng, rc.d service support |
hermes_cli/uninstall.py |
/usr/local/bin symlink removal on FreeBSD |
scripts/install-freebsd.sh |
Native FreeBSD installer (POSIX sh, pkg, uv) |
Clipboard (xclip) and voice (ffplay) work on FreeBSD without code changes — xclip and ffmpeg are available via pkg.
Service (rc.d)
After installing, run Hermes as a persistent system service under daemon(8):
# One-time setup
sudo pw groupadd hermes
sudo pw useradd hermes -g hermes -d /var/db/hermes -s /usr/sbin/nologin
sudo cp packaging/freebsd/hermes_daemon.in /usr/local/etc/rc.d/hermes_daemon
sudo chmod 555 /usr/local/etc/rc.d/hermes_daemon
# Configure Hermes before first start
sudo mkdir -p /var/db/hermes
sudo chown hermes:hermes /var/db/hermes
sudo -u hermes HERMES_HOME=/var/db/hermes hermes setup
sudo -u hermes HERMES_HOME=/var/db/hermes hermes model
# Enable and start
sudo sysrc hermes_daemon_enable=YES
sudo service hermes_daemon start
sudo service hermes_daemon status
The service stores config in /var/db/hermes (persistent) instead of
~/.hermes (tmpfs on live USB). Logs go to /var/log/hermes/gateway.log.
Install
sh scripts/install-freebsd.sh
License
MIT — same as upstream NousResearch Hermes Agent. No LGPL encumbrance.