Hermes Client Web UI - Setup Guide¶
Source: reason-machines/devtools-skills (59 installs) | GitHub Category: interface, dashboard
A web-based chat interface for the Hermes Agent by Nous Research. Manages multiple Hermes profiles as separate "agents", runs conversations with full streaming via SSE, and provides an interactive terminal for setup commands. Each UI agent maps 1:1 to a Hermes profile with its own home directory, config, and sessions.
Installation¶
# Install the skill
npx skills add reason-machines/devtools-skills --skill hermes-client-web-ui
# Clone and start the web UI
git clone https://github.com/lotsoftick/hermes_client.git
cd hermes_client
npm start
npm start builds, deploys to ~/.hermes_client, installs auto-start (LaunchAgent on macOS / Startup on Windows), and creates the global hermes_client command.
Prerequisites¶
| Requirement | Details |
|---|---|
| Node.js 18+ | Required for the web server |
| Hermes Agent | Must be installed with hermes on PATH |
| Git | Required for cloning and auto-update |
| Build Tools | Windows: Visual Studio Build Tools (for native modules) |
Key Capabilities¶
Core Features¶
| Capability | How to Trigger | Notes |
|---|---|---|
| Web chat interface | Open http://localhost:18888 |
Browser-based Hermes conversations |
| Multi-profile management | Select profile in UI dropdown | Each profile maps to ~/.hermes/profiles/<name>/ |
| SSE streaming | Automatic in chat | Real-time streaming of agent responses |
| Interactive terminal | Terminal tab in UI | Run hermes CLI commands directly |
| API access | http://localhost:18889 |
REST API for programmatic access |
| Auto-start service | npm start configures this |
LaunchAgent (macOS) or Startup (Windows) |
Service Management¶
hermes_client start # Start the web server
hermes_client stop # Stop the web server
hermes_client restart # Restart the web server
hermes_client status # Check if running
Default Access¶
| Resource | URL | Credentials |
|---|---|---|
| Web Client | http://localhost:18888 | admin@admin.com / 123456 |
| API | http://localhost:18889 | Same credentials |
CorpusIQ Use Cases¶
| Use Case | How |
|---|---|
| Team dashboard | Deploy on internal network for team access to shared Hermes profiles |
| Multi-agent monitoring | Manage separate profiles for Growth, Support, and Dev agents in one UI |
| Remote access | Tunnel via SSH or Tailscale to access Hermes from mobile/tablet |
| Demo environment | Use web UI for client demos - cleaner than terminal output |
| Training/onboarding | New team members interact with Hermes through familiar chat interface |
Troubleshooting¶
| Issue | Fix |
|---|---|
| Port 18888 already in use | Change port in ~/.hermes_client/config.json |
| "hermes not found" | Verify hermes is on PATH: which hermes |
| Blank page on load | Check Node.js version: node --version (needs 18+) |
| npm install fails (Windows) | Install Visual Studio Build Tools with "Desktop development with C++" |
| Auto-start not working | Re-run npm start to reconfigure LaunchAgent/Startup |
| Login fails | Default credentials: admin@admin.com / 123456 |
Verification¶
# Verify skill installed
hermes skills list | grep hermes-client-web-ui
# Start the web server
hermes_client start
# Check it's running
curl -s http://localhost:18889/api/health
# Open in browser
open http://localhost:18888 # macOS
# Or: xdg-open http://localhost:18888 # Linux
← Skills Catalog | Discovery Page → Curated by CorpusIQ - one MCP endpoint, all your business tools.
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.