# Hermes Control Interface

> A self-hosted web dashboard for the Hermes AI agent stack with terminal, file explorer, multi-agent gateway, RBAC, token analytics, and cron management.

Hermes Control Interface (HCI) is a self-hosted web dashboard built for the Hermes AI agent ecosystem, providing a unified control plane for managing AI agents, sessions, files, and system resources. It runs as a single Node.js process and exposes 100+ API endpoints covering authentication, agent profiles, chat, cron scheduling, skills management, and system administration. The interface features a full browser-based terminal via xterm.js, real-time streaming chat via Gateway API, and a robust multi-user RBAC system with 28 permissions across 12 groups.

- **Multi-Agent Gateway** — *Start, stop, configure, and monitor multiple Hermes agent profiles from one place with real-time log streaming and systemd service management.*
- **Chat Interface** — *Real-time SSE streaming chat via Gateway API with collapsible tool call cards, JSON viewer, session resume, stop button, and automatic CLI fallback.*
- **RBAC v2** — *28 permissions across 12 groups with built-in admin and viewer roles plus fully custom role assignment per user.*
- **Token Analytics** — *Track sessions, messages, tokens, and estimated cost broken down by model, platform, and configurable time ranges (today, 7d, 30d, 90d).*
- **Browser Terminal** — *Full PTY terminal via node-pty and xterm.js over WebSocket with touch-friendly controls, fullscreen toggle, and rate limiting.*
- **File Explorer** — *Split-view file editor with directory tree browser, syntax-highlighted editor, and path traversal prevention scoped to the Hermes home directory.*
- **Skills Marketplace** — *Browse, install, update, and uninstall Hermes skills grouped by category with trust level indicators and registry integration.*
- **Cron Management** — *Create, pause, resume, and run scheduled agent jobs with preset schedules and next-run time display.*
- **Security Hardened** — *bcrypt password hashing, CSRF tokens on 21 endpoints, dynamic CORS, WebSocket origin verification, XSS escaping, and rate limiting.*
- **Maintenance Panel** — *Run diagnostics, generate debug dumps, update Hermes, backup/restore data, manage users, view API key status, and review the full audit log.*
- **Dark & Light Themes** — *Toggle between dark and light modes with preferences persisted in localStorage.*

## Features
- Multi-agent gateway management
- Real-time SSE streaming chat
- Tool call cards with JSON viewer
- Session resume and management
- RBAC v2 with 28 permissions across 12 groups
- Token analytics by model, platform, and time range
- Browser-based PTY terminal via xterm.js
- Split-view file explorer with syntax highlighting
- Skills marketplace with install/uninstall/update
- Cron job scheduling with preset expressions
- System health monitoring (CPU, RAM, disk, uptime)
- Backup and restore functionality
- Activity audit log
- Dark and light theme toggle
- CSRF protection on 21 endpoints
- bcrypt password hashing
- Rate limiting on login and terminal exec
- Dynamic CORS configuration
- Systemd service management
- 100+ REST API endpoints

## Integrations
Hermes AI Agent, NousResearch Hermes Agent, OpenRouter, Nous Portal, Honcho (self-hosted memory), Telegram, WhatsApp, Discord, systemd, node-pty, xterm.js, Vite

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
3.4.0

## Links
- Website: https://github.com/xaspx/hermes-control-interface
- Documentation: https://github.com/xaspx/hermes-control-interface/blob/main/docs/API.md
- Repository: https://github.com/xaspx/hermes-control-interface
- EveryDev.ai: https://www.everydev.ai/tools/hermes-control-interface