Pan is a self-hosted web dashboard for Hermes Agent. It now ships a calmer, chat-first workspace with stronger discovery, clearer integrations information architecture, denser optional navigation, and more product-grade onboarding. Chat with your agent, manage skills from skills.sh, control MCP integrations, inspect memory, and operate profiles — all from one place.

Install

Prerequisites

• Node.js 18+ installed
• Hermes Agent installed and configured (~/.hermes)

One command

npx @euraika-labs/pan-ui

A setup wizard runs on first launch to connect Pan to your Hermes instance. After setup, open localhost:3199.

First time? The wizard auto-detects your Hermes home directory, API server, and installed binary. Just press Enter through the defaults to get started.

Run in the background

npx @euraika-labs/pan-ui start --daemon  # Fork to background
npx pan-ui status                        # Check if running
npx pan-ui logs                          # Tail log output
npx pan-ui stop                          # Stop the daemon

Run as a system service (Linux)

npx @euraika-labs/pan-ui service install   # Creates a systemd user service
npx pan-ui service remove                  # Uninstall it

The service starts on login and survives logout. Manage it with standard systemctl --user commands.

Update

npx @euraika-labs/pan-ui@latest

Your configuration in ~/.pan-ui/ is preserved across updates.

Features

| Feature | Description | |---------|-------------| | Chat | SSE streaming connected to a live Hermes runtime, with a chat-first workspace, calmer empty states, starter prompts, tool timelines, approval cards, and authenticated chat/session APIs | | Sessions | Unified session sidebar with source badges, source filtering, stronger selected states, cross-platform resumption, and optional compact density mode | | Marketplace | Discover-first /marketplace view for skills, MCP servers, and plugins with hero content, grouped global search, and clearer discovery vs installed inventory separation | | Skills | Browse installed skills, discover and install more from skills.sh, and load skills into active sessions | | Extensions / MCP | Clearer integrations IA for live integrations, MCP servers, tools, approvals, diagnostics, and runtime availability | | Plugins | Dedicated plugin workspace with stronger install validation, repo requirements guidance, enable/disable flows, and plugin detail APIs | | Memory | Inspect and edit global and profile-scoped agent memory | | Profiles | Isolated workspaces — each with its own sessions, skills, memory, and API keys | | Operations | Approvals, run history, audit trails, telemetry, health monitoring, and exports | | Daemon | Background process with PID management, log tailing, and systemd integration |

Screenshots

Streaming chat with session sidebar, tool timelines, and runtime-aware composer.

Installed skills with search and category filters. Discover tab for the skills.sh hub.

Configuration

CLI Reference

| Command | Description | |---------|-------------| | pan-ui / pan-ui start | Start in foreground | | pan-ui start --daemon | Start in background | | pan-ui start --port 8080 | Override port | | pan-ui stop | Stop daemon | | pan-ui status | Show running state | | pan-ui logs | Tail daemon logs | | pan-ui setup | Re-run setup wizard | | pan-ui update | Check for and install updates | | pan-ui sync-hermes | Update vendored Hermes to pinned version | | pan-ui version | Show current version | | pan-ui service install | Install systemd service | | pan-ui service remove | Remove systemd service | | pan-ui help | Show CLI usage |

Environment Variables

The setup wizard writes these to .env.local. You can also edit them directly or re-run npx pan-ui setup.

| Variable | Default | Description | |----------|---------|-------------| | HERMES_HOME | ~/.hermes | Hermes home directory | | HERMES_API_BASE_URL | http://127.0.0.1:8642 | Hermes API endpoint | | HERMES_API_KEY | — | API key (if Hermes requires one) | | HERMES_WORKSPACE_USERNAME | admin | Login username | | HERMES_WORKSPACE_PASSWORD | changeme | Login password | | HERMES_WORKSPACE_SECRET | (auto-generated) | Cookie signing secret | | HERMES_MOCK_MODE | false | Use mock data when runtime is unavailable | | PORT | 3199 | Server port |

File Locations

| Path | Purpose | |------|---------| | ~/.pan-ui/pan-ui.pid | Daemon PID file | | ~/.pan-ui/pan-ui.log | Daemon log output | | ~/.config/systemd/user/pan-ui.service | Systemd service unit (when installed) | | .env.local (in package dir) | Configuration from setup wizard |

How It Works

Pan runs as a standalone Next.js server that bridges your browser to the Hermes runtime. On startup it automatically launches the Hermes gateway if it isn't already running — no manual gateway setup required.

  Browser ──── fetch / SSE ────▶ Pan (Next.js API routes)
                                    │             │
                                    ▼             ▼
                              Hermes Gateway   Hermes Filesystem
                              :8642            ~/.hermes/
                              (auto-managed)   (skills, memory, profiles, state.db)
                                    │
                                    ▼
                              Hermes Agent sessions
                              (tools, streaming, full agent capabilities)

• Gateway — Pan's startup hook detects whether the Hermes gateway is reachable. If not, it spawns hermes gateway run as a child process with health monitoring and auto-restart. The gateway uses the active Hermes profile — no hardcoded names or paths.
• Vendored Hermes — Pan pins a specific Hermes Agent version via hermes.version.json. On first launch, if no hermes binary is found, the setup wizard installs it from the Euraika-Labs/hermes-agent fork. Use pan-ui sync-hermes to update.
• Chat streams through Hermes's OpenAI-compatible SSE endpoint
• Skills are read from ~/.hermes/skills/ with YAML frontmatter parsing
• Memory reads/writes USER.md and MEMORY.md at global and profile scope
• Profiles map to ~/.hermes/profiles/<name>/ directories

Already running a gateway? Pan detects it and skips auto-launch. This works with systemd services, manual hermes gateway run, or any external process on the configured port.

Development

Want to contribute or run from source? See CONTRIBUTING.md for full setup instructions.

git clone https://github.com/Euraika-Labs/pan-ui.git
cd pan-ui
npm install
npm run dev

| Command | Description | |---------|-------------| | npm run dev | Dev server with hot reload | | npm run build | Production build | | npm run lint | ESLint | | npm run test | Vitest unit tests | | npm run test:e2e | Playwright end-to-end tests |

Recent Changes

[0.7.1] — 2026-04-10

• Fixed post-0.7.0 regressions in skill installs, skill discovery parsing, MCP hub persistence, MCP probe refresh, stale hub metadata fallback, and command allowlist handling
• Improved install UX so blocked community skills can be force-installed intentionally and installed cards behave more predictably
• Verified current MCP install/test flows for ai.memestack/mcp and dev-fentz-envcp-envcp, plus release readiness with lint, tests, build, and dry-run packaging

[0.7.0] — 2026-04-09

• Added the full UX roadmap to main: chat-first workspace redesign, marketplace discovery refresh, integrations IA cleanup, compact navigation mode, and stronger login/onboarding guidance
• Changed shell hierarchy, session scanability, and discovery/install surfaces so Pan feels calmer and more product-grade without losing power-user depth
• Verified release readiness with npm run lint, npm run test (24/24), npm run build, Playwright suite enumeration (23 tests), and a clean npm pack --dry-run

[0.6.0] — 2026-04-09

• Added unified Marketplace, MCP Hub registry browsing, dedicated Plugins workspace, and expanded Playwright coverage (23 tests)
• Fixed plugin install hardening, skill-load/session regressions, bogus skills-hub success reporting, MCP Hub parsing/cache hydration, and unauthenticated chat/session API access
• Changed GitHub → GitLab mirror workflow now uses normal pushes instead of force-pushing protected main

[0.5.2] — 2026-04-09

• Fixed standalone npm packaging and runtime asset copying so published builds boot correctly from the installed package

[0.5.1] — 2026-04-08

• Fixed fork session crash (missing ) in Python bridge)
• Changed health probe decoupled from binary — Docker and headless deployments report full health status
• Added Docker test image with bundled Hermes Agent, Docker test suites (37 + 28 assertions), full-stack functional test (33 assertions), .dockerignore

[0.5.0] — 2026-04-08

• Added vendored Hermes fork (hermes.version.json), auto-install wizard, sync-hermes / update / version CLI commands, update banner
• Changed CLI refactored to subcommand structure, profile detection hardened

Full changelog →

Security

See SECURITY.md for reporting vulnerabilities.

License

MIT © Euraika Labs