Hermes Workspace AI Agent UI - Setup Guide¶

Source: reason-machines/hermes-skills (196+ installs) Category: Hermes Agent / UI & Workspace Quality Tier: 🟡 Beta

Hermes Workspace is a native web interface for Hermes Agent that goes beyond chat - it's a complete workspace with file browsing, persistent sessions, role-based agent dispatch, swarm mode for managing multiple Hermes Agent workers, a 2,000+ skill catalog browser, and full MCP integration. Built with Next.js, Monaco editor, and PTY terminal support.

Installation¶

npx skills add reason-machines/hermes-skills --skill hermes-workspace-ai-agent-ui

One-Line Install¶

curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash

Docker Compose (Recommended)¶

git clone https://github.com/outsourc-e/hermes-workspace.git
cd hermes-workspace
docker-compose up -d
# Access at http://localhost:3000

Manual¶

git clone https://github.com/outsourc-e/hermes-workspace.git
cd hermes-workspace
pnpm install
cp .env.example .env
echo 'HERMES_API_URL=http://127.0.0.1:8642' >> .env
pnpm dev

Prerequisites¶

Requirement	Details
Node.js	22+ required
pnpm	Package manager
Hermes Agent Gateway	Running on port 8642 (`hermes gateway run`)
Hermes Dashboard	Optional, port 9119 for enhanced features

Key Capabilities¶

Complete Agent Workspace¶

Chat Interface: Real-time SSE streaming, tool call rendering, multi-session with markdown + syntax highlighting
Terminal & Files: Monaco-powered file browser with cross-platform PTY terminal
Memory Browser: Search, edit, and manage agent memory with live markdown editor
Skills Catalog: Browse 2,000+ skills with origin badges, filters, and source paths
MCP Integration: Full Model Context Protocol catalog, marketplace, and source management

Swarm Mode (Multi-Agent)¶

Persistent tmux-backed agent workers with role-based dispatch: - builder: Code implementation - reviewer: PR review and validation - docs: Documentation - research: Investigation - ops: Operations and deployment - triage: Issue classification - qa: Quality assurance - lab: Experiments

Conductor Mission Dispatch¶

Mission decomposition and dispatch with fallback to native swarm orchestration. Supports auto-decomposition mode and Kanban task board.

PWA Support¶

Install as native app, access over Tailscale. Works on mobile devices.

Quick Start¶

# Terminal 1: Start gateway
hermes gateway run

# Terminal 2: Start dashboard (optional)
hermes dashboard

# Terminal 3: Start workspace
cd ~/hermes-workspace && pnpm dev

# Access at http://localhost:3000

Swarm Mode¶

cd ~/hermes-workspace
pnpm swarm:start
# Configure roles in UI: Settings → Swarm → Configure Roles

Remote Access via Tailscale¶

echo 'HERMES_API_URL=http://100.x.y.z:8642' >> .env
# Gateway must bind to 0.0.0.0
echo 'API_SERVER_HOST=0.0.0.0' >> ~/.hermes/.env

Verification¶

# Verify gateway
curl http://127.0.0.1:8642/health

# Verify workspace
curl http://localhost:3000

# Check swarm workers
pnpm swarm:status

# Check connection in Settings → Connection → Test Connection

Notes¶

Supports local models (Ollama, LM Studio, Atomic Chat) by pointing HERMES_API_URL to their endpoints
Multi-container Docker setup available for production with gateway, dashboard, and workspace orchestration
Custom themes configurable in src/styles/themes/ with full color/font customization
Workspace caches build artifacts - clear .next and rebuild if memory issues occur
Swarm workers use tmux sessions - check tmux ls to verify worker processes

Integration with CorpusIQ¶

CorpusIQ is the connector layer that lets AI assistants read the systems a business already runs on - accounting, payments, CRM, email, files and analytics - and answer with the source named. It is read-only by design: it retrieves data and never writes to, or acts in, a connected system, which is what makes it safe to point at live accounts.

This page is part of the CorpusIQ directory, the reference we maintain for the MCP server and agent-skill ecosystem. Run alongside CorpusIQ, a third-party server like this one can be combined with a company's own business data in a single answer.

See what CorpusIQ connects