Hermes Workspace

Your AI agent's command center — v2.0.0 / MIT / Node 22+

1 — 概要
位置づけ

Hermes Workspace は、NousResearch/hermes-agent 向けのデスクトップ型 Web ワークスペース。チャット、ファイル、メモリ、スキル、ターミナル、Conductor によるオーケストレーションを 1 つの UI に集約する（単なるチャットラッパーではなく、完全なワークスペースを目指す設計）。v2 では zero-fork — 上流の hermes-agent を Nous 公式インストーラで入れ、パッチなしで接続する。

Vite 7TanStack Start
React 19UI
:3000既定ポート
:8642ゲートウェイ例
解説元: ローカル repos/hermes-workspace の README / package 情報に基づく。リポジトリ本家は outsourc-e/hermes-workspace。
2 — 技術スタック
主要依存（抜粋）
層採用用途のイメージ
フレームワークVite 7, TanStack Start / Router, React 19SSR 付きルーティング、API ルート、フロント画面
状態・データZustand, TanStack Queryチャットストア、サーバー同期
UITailwind CSS 4, @base-ui/react, xterm, Monaco, Rechartsターミナル、エディタ、ダッシュボード
品質Vitest, ESLint, Prettierテストと静的解析
3 — アーキテクチャ
接続の概念

ブラウザ上の Hermes Workspace は、環境変数 HERMES_API_URL で指した バックエンドに HTTP で接続する。Hermes ゲートウェイが有効で API サーバーが立ち上がっていると、セッション・メモリ・スキル・ジョブなどの 拡張 API が利用可能になる。純粋な OpenAI 互換（チャット＋モデル一覧）だけに繋いだ場合は、チャットは動くが拡張パネルは制限付き（README が「ポータブル」として説明する挙動）。

接続
flowchart LR U[Hermes Workspace UI] -->|HTTP / SSE| R[TanStack サーバー + API ルート] R -->|HERMES_API_URL| G[Hermes Gateway または互換 API] G --> P[LLM プロバイダ] G --> E[拡張: sessions / memory / skills / jobs]
4 — 起動と接続
例: 既存ゲートウェイに取り付ける

ゲートウェイが 127.0.0.1:8642 で待ち受けている前提の最小手順（README より）。

git clone https://github.com/outsourc-e/hermes-workspace.git
cd hermes-workspace
pnpm install
cp .env.example .env
echo 'HERMES_API_URL=http://127.0.0.1:8642' >> .env
# ゲートウェイに API_SERVER_KEY がある場合は HERMES_API_TOKEN に同じ値
pnpm dev   # http://localhost:3000

エージェント側の前提: ゲートウェイが到達可能なアドレスに束縛され、API_SERVER_ENABLED=true（~/.hermes/.env 等）。API_SERVER_KEY を使う場合はワークスペース側のトークンと一致させる。検証: curl http://127.0.0.1:8642/health。

1 行インストール

README の install.sh は hermes-agent（PyPI）の導入、リポジトリ取得、.env、依存インストールまで一括で行い、その後 hermes gateway run と pnpm dev の 2 ターミナル運用を想定している。

5 — ポータブルモードと拡張
2 層の使い方
モード接続先の例期待される挙動
ポータブルAtomic Chat、Ollama など /v1 のみチャットは可。README のとおり、セッション / メモリ / スキルは「Not Available」表示になり得る
拡張（フル）Hermes ゲートウェイ + API_SERVER_ENABLEDセッション永続、メモリ、スキル、ダッシュボード、ジョブ等が有効化
ローカル推論（README の例）

Ollama 例: HERMES_API_URL=http://127.0.0.1:11434 で pnpm dev。Atomic Chat や拡張モード用の config.yaml 形は README に記載がある。

6 — Docker
構成

docker compose up は hermes-agent イメージ（ポート 8642）と hermes-workspace イメージ（ポート 3000）を併起する。永続は hermes-data ボリューム。本番想定のイメージ例: ghcr.io/outsourc-e/hermes-workspace:latest（linux/amd64 / arm64）。

注意: ゲートウェイにモデルが到達可能であること。API キーまたはローカル推論のどちらかが必須（README）。
7 — 画面・機能（README ベース）
ハイライト
  • Hermes ゲートウェイへの接続と SSE ストリーミング、ツール呼び出しの可視化
  • 8 テーマ（公式 / Classic / Slate / Mono × ライト・ダーク）
  • 全 API ルートへの 認可、CSP、実行承認などセキュリティ配慮
  • PWA — 同一機能をモバイル・Tailscale 経由でも利用可能な設計
  • メモリとスキル のブラウジング・検索・編集、多数のスキルにアクセス
公式