clawdie/layered-soul
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
layered-soul/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md
Hermes & Sam 9c332b1b78 docs: expand agent matrix — 5 agents across 3 hosts, Hermes-FreeBSD integration plan 
- Agent roster: add Autolycus (Hermes fork on FreeBSD 15/OSA)
- AGENTS.md: full 5-agent matrix with harness/OS/role
- New doc: CLAIRE-FREEBSD-HERMES-INTEGRATION.md — phased plan
- Added hermes-freebsd to private sources list
2026-06-14 03:09:17 +02:00

3.7 KiB
Raw Blame History

Clawdie + Hermes-FreeBSD Integration Plan

What we have

hermes-freebsd (code.smilepowered.org/clawdie/hermes-freebsd): An LGPL v2.1 fork of Hermes Agent by Technetia Inc (branded as "Autolycus"), targeting FreeBSD natively. 8,526 files, 532MB. Audited April 2026 against FreeBSD 15.0-RELEASE-p5.

Key facts:

  • Runs on FreeBSD without emulation or containers
  • CLI, Telegram gateway, TUI all functional on FreeBSD
  • scripts/install-freebsd.sh provides native installation
  • Core agent logic is platform-agnostic Python — same codebase as upstream Hermes
  • Gaps: no FreeBSD wheels for faster-whisper (voice), no clipboard implementation

Why this matters for Clawdie

Currently OSA (FreeBSD 15 host) runs Codex CLI for ISO builds and cargo validation. It has no Hermes instance — all orchestration happens on debby (Linux). Adding Autolycus to OSA gives us:

Capability Before After
Hermes on FreeBSD ❌ None ✅ Native
ISO-side agent ❌ Codex only ✅ Hermes + Codex
layered-soul on FreeBSD ❌ No ✅ Via adapters/hermes.md
Headroom on FreeBSD ❌ No path ✅ Python works natively
Colibri + Hermes co-host ❌ Linux only ✅ Both on FreeBSD
Telegram gateway on OSA ❌ No ✅ Direct from FreeBSD

Phased integration

Phase 1: Standalone test (OSA side)

  1. Install Autolycus on OSA via scripts/install-freebsd.sh
  2. Configure with a provider (DeepSeek or OpenRouter)
  3. Verify basic functionality: terminal execution, file ops, web search
  4. Test Telegram gateway on OSA
  5. Document what works and what doesn't on FreeBSD 15

Phase 2: Identity injection

  1. Clone layered-soul on OSA
  2. Load SOUL.md, USER.md, IDENTITY.md, AGENTS.md as profile context
  3. Verify Autolycus operates with the same identity as Hermes on debby
  4. Test: can Autolycus on OSA read the same skills as Hermes on debby?

Phase 3: Colibri co-hosting

  1. Both Autolycus and colibri-daemon run on OSA simultaneously
  2. Autolycus can issue socket commands to the daemon (cmd_status, etc.)
  3. Headroom sidecar runs on OSA (Python works natively)
  4. Test: ISO build triggered by Autolycus, results reported via Telegram

Phase 4: ISO shipping

  1. Add Autolycus to Clawdie ISO package list
  2. Pre-configure with layered-soul identity
  3. Install as a FreeBSD service alongside colibri-daemon
  4. First-boot wizard optionally sets up Hermes

Agent matrix (expanded)

Agent Host Harness OS Model Role
Hermes debby Hermes Agent (upstream) Debian 13 DeepSeek v4 Orchestrator, soul backup
Zot debby Zot RPC Debian 13 GLM-5.1 Coding, media
Claude domedog Claude Code Linux Claude Verification, review
Codex osa Codex CLI FreeBSD 15 GPT ISO builds, validation
Autolycus osa Hermes Agent (fork) FreeBSD 15 TBD Native FreeBSD agent

Gaps to close (from FreeBSD audit)

Gap Severity Fix
faster-whisper wheels Medium Build from source, or skip voice on FreeBSD
Clipboard support Low Implement xclip/xsel equivalent for FreeBSD
Docker/Singularity backends Low Skip — Colibri provides jail-based isolation
Platform detection in setup.py Medium Add FreeBSD branches (upstreamable)

Files to touch

File Change
layered-soul/memories/curated/agent-roster.md Add Autolycus row
layered-soul/AGENTS.md Add Autolycus to agent references
layered-soul/docs/PLAN-CONFIGURE-PRIVATE-REPO.md Add Phase 5: FreeBSD agent
clawdie-ai/docs/ (or handoff) Agent matrix expansion note
colibri/docs/AGENTS.md Note FreeBSD-side Hermes availability