hermes-os/README.md

Hermes OS

Mobile-first dashboard for Hermes Agent. View memory, browse sessions, manage skills, edit your persona — all from your phone.

Quick Start

npm ci
HERMES_BACKEND_URL=http://127.0.0.1:8643 npx next build
HERMES_BACKEND_URL=http://127.0.0.1:8643 npx next start -p 3100 -H 0.0.0.0

Requires the Hermes WebAPI running (FastAPI, typically on port 8643).

Modules

• Pulse — status, recent sessions, memory usage, quick links
• Memory — view/edit agent + user memory entries
• History — session list, platform filter, full-text search, session replay
• Skills — browse all skills by category, view SKILL.md content
• Cron — view scheduled jobs, trigger manually
• Soul — edit SOUL.md persona file

Environment

Variable	Default	Description
HERMES_BACKEND_URL	http://127.0.0.1:8643	Hermes WebAPI (FastAPI)
HERMES_GATEWAY_URL	http://127.0.0.1:8642	Hermes Gateway (aiohttp)
HERMES_SOUL_PATH	~/.hermes/SOUL.md	Path to persona file

Stack

Next.js 15, TypeScript, Tailwind CSS, TanStack Query, Lucide icons. PWA-ready.