hermes-bsd/README-FreeBSD.md
Sam & Claude 7aa46cc9f8
Some checks are pending
Nix / nix (macos-latest) (push) Waiting to run
Nix / nix (ubuntu-latest) (push) Waiting to run
Typecheck / typecheck (apps/bootstrap-installer) (push) Waiting to run
Typecheck / typecheck (apps/desktop) (push) Waiting to run
Typecheck / typecheck (apps/shared) (push) Waiting to run
Typecheck / typecheck (ui-tui) (push) Waiting to run
Typecheck / typecheck (web) (push) Waiting to run
docs(freebsd): correct patched-file list (3 changes, drop phantom voice_mode.py)
The README claimed "six targeted changes" and listed tools/voice_mode.py as
patched, but commit a9e4caa3f touched only three code files (setup.py,
uninstall.py, install-freebsd.sh) plus this README. voice_mode.py was never
modified — voice works on FreeBSD via pkg-installed ffplay without code
changes, as the same README already states. Drop the phantom row and fix the
count.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 15:13:06 +02:00

845 B

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.

Install

sh scripts/install-freebsd.sh

License

MIT — same as upstream NousResearch Hermes Agent. No LGPL encumbrance.