如何设置 Hermes Workspace

1. 运行： curl -fsSL https://hermes-workspace.com/install.sh | bash

2. 安装程序：

• 如需要，安装 Hermes Agent
• 设置 Workspace
• 自动将其与本地的 vanilla Hermes 配对

3. 启动 Workspace： cd ~/hermes-workspace PORT=3002 pnpm dev

4. 打开应用——它已经与本地 Hermes 后端 + 仪表盘自动配对

另外：

• pnpm setup:local = 标准的手动配对命令
• pnpm pair:local = 兼容性别名

来源：https://hermes-workspace.com/install.sh #!/usr/bin/env bash # Project Workspace — 一键安装脚本 # # 用法： # curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash # # 功能： # 1. 检查 Node 22+、git、pnpm # 2. 通过 Nous 的官方上游安装程序安装 hermes-agent # (hermes-agent 不在 PyPI 上；它是由 Nous 处理的源码安装) # 3. 克隆 hermes-workspace # 4. 设置 .env，安装依赖，链接捆绑的技能 # # 可重复运行。已安装的内容会跳过。 set -euo pipefail REPO_URL=“\{REPO\_URL:\-https://github\.com/outsourc\-e/hermes\-workspace\.git\}" INSTALL\_DIR="{INSTALL_DIR:-HOME/hermes\-workspace\}" GATEWAY\_PORT="{GATEWAY_PORT:-8642}” WORKSPACE_PORT=“\{WORKSPACE\_PORT:\-3000\}" NOUS\_INSTALLER\_URL="{NOUS_INSTALLER_URL:-https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh}” # ─── 辅助函数 ────────────────────────────────────────────────────────────── cyan() { printf “\033[36m%s\033[0m\n” “\*"; \} green\(\) \{ printf "\\033\[32m%s\\033\[0m\\n" "*”; } yellow() { printf “\033[33m%s\033[0m\n” “\*"; \} red\(\) \{ printf "\\033\[31m%s\\033\[0m\\n" "*”; } bold() { printf “\033[1m%s\033[0m\n” “\*"; \} need\(\) \{ command \-v "1” &>/dev/null || { red “缺少: 1"; red "2”; exit 1; }; } banner() { cat <<‘EOF’ ╭────────────────────────────────────────────╮ │ PROJECT WORKSPACE — 零分支安装程序 │ │ outsourc-e/hermes-workspace │ ╰────────────────────────────────────────────╯ EOF } # ensure_path: 如果目录不在 PATH 中，则为当前 shell 添加到 PATH ensure_path() { local candidate=“1" \[\[ \-d "candidate” ]] || return 0 case “:PATH:" in \*":candidate:”*) ;; *) export PATH=“candidate:PATH” ;; esac } # ─── 前置检查 ──────────────────────────────────────────────────────────── banner cyan “→ 检查先决条件…” need node “安装 Node 22+: https://nodejs.org/” node_major=\(node \-v \| sed \-E 's/v\([0-9]\+\)\.\*/\\1/'\) if \[\[ "node_major“ -lt 22 ]]; then red “检测到 Node $node_major；需要 22+。” exit 1 fi green “ Node $(node -v) ✓“ need git “安装 git: https://git-scm.com/” green “ git $(git –version | awk ‘{print $3}’) ✓“ need curl “安装 curl（通常：apt install curl / brew install curl）” green “ curl ✓“ if ! command -v pnpm &>/dev/null; then yellow “ 未找到 pnpm — 通过 corepack 安装…“ corepack enable 2>/dev/null || npm install -g pnpm fi green “ pnpm (pnpm --version) ✓" \# ─── 安装 hermes\-agent（委托给 Nous 上游安装程序）────────── \# hermes\-agent 不在 PyPI 上。它通过 Nous 自己的脚本从源码安装， \# 该脚本处理 PEP 668、uv、Python 工具链、Termux 等。 \# 我们只需要确保 `hermes` 在继续之前出现在 PATH 上。 cyan "→ 安装 hermes\-agent（通过 Nous 上游安装程序）..." \# 如果 hermes 是在之前的运行中安装的但尚未在 PATH 上，则将其加入 ensure\_path "HOME/.hermes/bin“ ensure_path “HOME/\.local/bin" if command \-v hermes &\>/dev/null; then green " hermes\-agent 已安装 ✓ ((command -v hermes))” else yellow “ 委托给：NOUS\_INSTALLER\_URL" if \! curl \-fsSL "NOUS_INSTALLER_URL“ | bash; then red “ Nous 安装程序失败。请查看其输出以了解详情。“ red “ 您可以手动重试：“ red “ curl -fsSL NOUS\_INSTALLER\_URL | bash" exit 1 fi \# Nous 通常将 `hermes` 安装到 ~/\.hermes/bin 或 ~/\.local/bin ensure\_path "HOME/.hermes/bin“ ensure_path “HOME/\.local/bin" if \! command \-v hermes &\>/dev/null; then red " hermes\-agent 已安装，但 'hermes' 在此 shell 中未出现在 PATH 上。" yellow " 打开新 shell（或执行 source ~/.bashrc / ~/.zshrc）并重新运行：" yellow " curl -fsSL https://hermes-workspace.com/install.sh | bash" exit 1 fi green " hermes\-agent 已安装 ✓ ((command -v hermes))” fi # ─── 克隆 workspace ────────────────────────────────────────────────────── cyan “→ 克隆 hermes-workspace…” if [[ -d “$INSTALL_DIR” ]]; then yellow “ INSTALL\_DIR 已存在；拉取最新版本" git \-C "INSTALL_DIR“ pull --ff-only else git clone “REPO\_URL" "INSTALL_DIR” fi cd “$INSTALL_DIR” green “ Workspace 已准备好，位于 INSTALL\_DIR ✓" \# ─── 环境变量 + 安装 ──────────────────────────────────────────────────────── cyan "→ 配置 .env..." if \[\[ \! \-f \.env \]\]; then cp \.env\.example \.env fi if \! grep \-q "HERMES\_API\_URL=" \.env 2\>/dev/null; then printf '\\nHERMES\_API\_URL=http://127\.0\.0\.1:%s\\n' "GATEWAY_PORT“ >> .env fi green “ .env 已准备 ✓“ cyan “→ 安装 npm 依赖（pnpm install）…” pnpm install --silent green “ 依赖已安装 ✓“ # ─── 植入 Hermes 技能（Conductor 需要 workspace-dispatch）───────────── cyan “→ 将捆绑的技能链接到 ~/.hermes/skills…” HERMES_SKILLS_DIR=“HOME/\.hermes/skills" mkdir \-p "HERMES_SKILLS_DIR” if [[ -d “INSTALL\_DIR/skills" \]\]; then for skill\_path in "INSTALL_DIR/skills”/*/; do skill_name=\(basename "skill_path“) target=“HERMES\_SKILLS\_DIR/skill_name” if [[ -e “target" \|\| \-L "target” ]]; then continue fi ln -sf “skill\_path" "target” 2>/dev/null && \ green “ 已链接 $skill_name ✓“ || true done fi # ─── 完成 ───────────────────────────────────────────────────────────────── bold “” bold “━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━” green “ 安装完成！“ bold “━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━” cat <