GitHubGet StoixGitHub

Visual UI for Hermes Agent

Stoix

See the work. Keep the context.

Projects, split conversations, live tool activity, models, skills, plugins, settings, and logs in one local interface—while Hermes remains the runtime.

Explore Stoix Install Stoix
macOS · Windows · LinuxPer-user installationLoopback-bound local services

01 · Product tour

See how Stoix works before you install it.

A concise tour of the real workspace patterns in Stoix, the visual interface for Hermes Agent.

01Organize

Projects give every task a home.

Create and switch projects from the left rail. Each project keeps related conversations and local workspace state together while Hermes remains the runtime.
  • Project-scoped chats
  • Persistent browser workspace
  • Pane-local tabs
Understand the workspace model

02Compare

Open two conversations side by side.

Move chats between the left and right panes, keep multiple tabs open in each pane, focus one side when needed, and restore the split without losing the work.
  • Two independent chat panes
  • Tabs move between panes
  • Single-pane focus mode
Read about conversations

03Observe

Watch agent work—not just the final answer.

Streaming text, tool activity, approvals, failures, and completed work remain visually distinct, so long-running work can be followed without reading raw logs.
  • Streaming responses
  • Tool and approval states
  • Visible failures and recovery
Explore the agent experience

04Control

Manage your local Hermes connection.

Models, plugins, skills, credential status, private configuration, settings, and redacted logs are visible from the same shell while secrets remain behind the local server boundary.
  • Hermes model status
  • Skills and plugins
  • Configuration and copyable logs
Open configuration guidance

02 · Skills & plugins

Your Hermes capabilities, made visible.

Stoix presents the skills, plugins, and model choices reported by your local Hermes runtime. Search the catalog, inspect the details, and control supported entries from one visual surface.

Clear roles

One local interface. Hermes remains the runtime.

Stoix organizes the workspace you see. Its local server boundary keeps Hermes credentials out of browser JavaScript. Hermes continues to own agent sessions, models, tools, skills, plugins, and channels.

Workspace model Security boundary
  1. StoixWeb-based workspace
  2. Local boundaryCredentials stay server-side
  3. Hermes AgentAgent runtime
  4. External capabilitiesModels · tools · providers

Marks identify catalog examples. Availability depends on your Hermes setup; no affiliation or endorsement is implied.

03 · Installation

One command.
Your machine.

Already using Hermes Agent? Choose your operating system and install Stoix directly. The installer detects the processor, installs per user, and configures the local connection.

No administrator access No preinstalled Node.js Inspectable bootstrap scripts

Install Stoix

Terminal
$ curl -fsSL https://raw.githubusercontent.com/finxray/hermes-ui/master/install.sh | sh

macOS 12 or later · Apple silicon or Intel · installs in your user account. No preinstalled Node.js required.

Starting without Hermes

Install Hermes first.
Then add Stoix.

Use the official Hermes installer, finish its provider setup, and run hermes doctor—it must be clean before you install Stoix. Stoix configures the local API connection without moving your provider credentials into the browser.

01Install Hermes Agent
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
02Reload your shell
source ~/.zshrc
03Verify Hermes
hermes doctor
04Install Stoix
curl -fsSL https://raw.githubusercontent.com/finxray/hermes-ui/master/install.sh | sh

Officially supported on Apple silicon. Finish the Hermes provider setup, then verify it before installing Stoix. Stoix configures its local Hermes connection; provider credentials stay in Hermes.

Official Hermes installation guide
01Run the command

Keep the terminal open while Stoix and Hermes are prepared.

02Finish provider setup

Hermes may ask you to sign in or supply your own model-provider key.

03Verify the connection

Open a new terminal and run stoix --doctor.

Keep nearby

Three commands cover the everyday lifecycle.

Open Stoix

Launch the installed local interface in your default browser.

Check the connection

Verify the package, configuration, and Hermes reachability without printing secrets.

Update when you choose

Install the newest Stoix version while preserving local configuration and data.

Complete installation guide

04 · Architecture

Local by design.

A clear, inspectable boundary between the browser, Stoix, and Hermes Agent.

Your browser01

Stoix workspace

Projects, conversations, models, files, and controls remain organized in a local visual interface.

Local boundary02

Stoix BFF

Credentials stay server-side and state-changing browser requests are validated before reaching Hermes.

Agent runtime03

Hermes Agent

Models, tools, skills, plugins, agent sessions, and external channels continue to belong to Hermes.

Credentials remain server-sideServices bind to 127.0.0.1Updates require your action
Read the complete security model

05 · Operate

Know what is happening locally.

The practical details remain available when you need them, without overwhelming the first view.

Configure

Private settings stay per user

Find the Hermes endpoint, private credential settings, Stoix port, and platform-specific configuration paths.

Open configurationStore

Know where local data lives

Understand browser presentation state, durable attachments, Hermes sessions, and immutable application versions.

Review data and storageVerify

Check the complete connection

Use Stoix Doctor to inspect package readiness, active configuration, local endpoints, and Hermes reachability.

Run a health checkStay current

Updates remain your action

Run stoix update when you choose. Stoix preserves local configuration and data instead of updating silently.

Read the update policy

06 · Documentation

Everything you need to start.

Clear setup, verified product boundaries, and practical recovery guidance.