Published: 2026-06-01

Hermes Workspace: Add Multiple Models and Run Agent Swarms

Chapters / key moments (click to jump — plays here on the page)

Hermes Workspace is a community-built graphical interface for Hermes agent that lets you switch between multiple AI models, run parallel agent swarms, and manage everything from one browser tab. This video walks through installation, adding providers via OAuth, and the real-world friction you'll hit along the way.

Source video

"Hermes Workspace: New Mission Control is INSANE!" by Julian Goldie SEO — Watch on YouTube →

Key Takeaways

Install Hermes Workspace with a single terminal command, then start it with hermes gateway run followed by hermes gateway UI.
Add models like Grok or Mistral via hermes model and authenticate with OAuth—reuse your existing Twitter/X or other subscriptions, no new API keys needed.
Hermes Workspace runs at localhost:3000 and needs three backend ports synced—expect some back-and-forth getting the initial setup stable.
Agent swarms (multiple Hermes profiles running in parallel) are configured in the Operations → Swarm section of the workspace UI.
When backend sync fails, paste the Hermes GitHub docs into Claude Code and ask it to fix the configuration for you—much faster than debugging manually.

Installation and Startup

Run the one-line install command from the Hermes Workspace GitHub page in your terminal. Once installed:

hermes gateway run
hermes gateway UI

The UI opens at localhost:3000. If that port is already in use by another service, you'll need to change the port in the config—Claude Code can handle this automatically if you paste the workspace documentation into it.

Make sure bypass permissions is enabled in Claude (desktop or code) before starting—it significantly reduces the back-and-forth when Claude is fixing backend configuration issues.

Adding Multiple Models

Inside the workspace, go to Settings → Model and Provider Settings. From there:

hermes model

This command lists available model providers. Select a provider (Grok, Mistral, OpenAI Codex, Llama, etc.) and complete the OAuth flow in the browser. Once authorized, the model appears as a selectable option inside Hermes Workspace. You can also add raw API keys for custom endpoints.

Note: Not all providers support every authentication method. Groq, for example, may not be fully available through the workspace UI yet—Hermes is moving fast and some integrations lag behind the CLI experience.

Agent Swarms

Hermes Workspace includes an Operations → Swarm section where you can create multiple agent profiles and run them simultaneously. Each profile can have a different model, persona, and task focus. The workspace also includes a chat view, file manager, terminal, conductor, and office section—making it a fairly complete mission control for multi-agent workflows.

Workspace vs. Agent OS: Which to Use?

Hermes Workspace is powerful but requires more setup effort. The creator recommends it for users who want a dedicated UI for Hermes specifically. If you want a simpler alternative with custom SEO, content, and studio workflows already built in—a custom Agent OS dashboard (built in Next.js) is easier to manage and ships daily updates. The two approaches aren't mutually exclusive.

Commands & Code Mentioned

hermes gateway run
hermes gateway UI
hermes model