Hermes Switch UI — Dual-Process Architecture

Browser-based shell (port 3000) paired with the Hermes Agent gateway (port 8642)

Your Browser Chrome / Firefox Safari / Edge Hermes Switch UI port 3000 • TanStack Start Chat composer + thread Sessions history sidebar Files tree + editor Boards kanban Workflows DAG editor Settings themes + provider Memory wiki + agent mem Skills / MCP marketplace Server module (TanStack Start) auth-middleware • hermes-api proxy SSE relay • /api/* routes Hermes Agent (gateway) port 8642 • Python runtime Session manager turn loop + memory Provider router model selection Tool runner bash, edit, search Skills loader user + bundled Memory store agent + wiki MCP host external servers Workflow engine DAG executor Kanban plugin boards + tasks API surface (REST + SSE + WS) /health • /api/sessions • /api/send /api/skills • /api/mcp • /api/kanban ~/.hermes/ (persistent storage) • sessions.db • memory/ • MEMORY.md • profiles/ • skills/ • mcp_servers/ • workflows/ • kanban.db • config.yaml • .env • workspace-sessions.json • workspace-overrides.json Anthropic api.anthropic.com OpenAI api.openai.com OpenRouter openrouter.ai Google generativelanguage.googleapis.com Local: Ollama 127.0.0.1:11434 Custom endpoint any OpenAI-compatible HTTP / WS REST + SSE reads / writes auth tokens API calls Legend Switch UI Hermes Agent Storage External Process boundary

Switch UI (port 3000)

  • • Browser-based TanStack Start app
  • • Auth-gated workspace UI
  • • Streams responses via SSE
  • • Persists nothing locally (state in agent)

Hermes Agent (port 8642)

  • • Python gateway runtime
  • • Owns sessions, memory, skills, MCP
  • • Routes prompts to chosen provider
  • • Runs workflow DAGs and tools

~/.hermes/ storage

  • • Sessions DB + memory files
  • • Installed skills + MCP servers
  • • Provider config + API keys
  • • Survives restarts and crashes

Hermes Switch UI • dual-process architecture