@outsource_: How to set up Hermes Workspace 1. Run: curl -fsSL https://hermes-workspace.com/install.sh | bash 2. The installer: - in…

How to set up Hermes Workspace

1. Run: curl -fsSL https://hermes-workspace.com/install.sh | bash

2. The installer:

• installs Hermes Agent if needed
• sets up Workspace
• pairs it with your local vanilla Hermes automatically

3. Start Workspace: cd ~/hermes-workspace PORT=3002 pnpm dev

4. Open the app — it comes up already paired to your local Hermes backend + dashboard

Also:

• pnpm setup:local = canonical manual pairing command
• pnpm pair:local = compatibility alias

Source: https://hermes-workspace.com/install.sh #!/usr/bin/env bash # Project Workspace — one-liner installer # # Usage: # curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash # # What it does: # 1. Verifies Node 22+, git, pnpm # 2. Installs hermes-agent via Nous’s official upstream installer # (hermes-agent is NOT on PyPI; it’s a source install handled by Nous) # 3. Clones hermes-workspace # 4. Sets up .env, installs deps, links bundled skills # # Re-runnable. Will skip anything already installed. 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}” # ─── helpers ────────────────────────────────────────────────────────────── 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 “Missing: 1"; red "2”; exit 1; }; } banner() { cat <<‘EOF’ ╭────────────────────────────────────────────╮ │ PROJECT WORKSPACE — zero-fork installer │ │ outsourc-e/hermes-workspace │ ╰────────────────────────────────────────────╯ EOF } # ensure_path: prepend a dir to PATH for this shell if it’s not already there ensure_path() { local candidate=“1" \[\[ \-d "candidate” ]] || return 0 case “:PATH:" in \*":candidate:”*) ;; *) export PATH=“candidate:PATH” ;; esac } # ─── preflight ──────────────────────────────────────────────────────────── banner cyan “→ Checking prerequisites…” need node “Install 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 detected; need 22+.” exit 1 fi green “ Node $(node -v) ✓“ need git “Install git: https://git-scm.com/” green “ git $(git --version | awk ‘{print $3}’) ✓“ need curl “Install curl (usually: apt install curl / brew install curl)” green “ curl ✓“ if ! command -v pnpm &>/dev/null; then yellow “ pnpm not found — installing via corepack…“ corepack enable 2>/dev/null || npm install -g pnpm fi green “ pnpm \(pnpm \-\-version\) ✓" \# ─── install hermes\-agent \(delegate to Nous upstream installer\) ────────── \# hermes\-agent is NOT on PyPI\. It installs from source via Nous's own \# script, which handles PEP 668, uv, Python toolchain, Termux, etc\. We \# only need to ensure \`hermes\` ends up on PATH before continuing\. cyan "→ Installing hermes\-agent \(via Nous upstream installer\)…" \# Pick up hermes if it was installed in a prior run but not on PATH yet ensure\_path "HOME/.hermes/bin“ ensure_path “HOME/\.local/bin" if command \-v hermes &\>/dev/null; then green " hermes\-agent already installed ✓ \((command -v hermes))” else yellow “ Delegating to: NOUS\_INSTALLER\_URL" if \! curl \-fsSL "NOUS_INSTALLER_URL“ | bash; then red “ Nous installer failed. See its output above for details.“ red “ You can retry manually:“ red “ curl -fsSL NOUS\_INSTALLER\_URL \| bash" exit 1 fi \# Nous typically installs \`hermes\` to ~/\.hermes/bin or ~/\.local/bin ensure\_path "HOME/.hermes/bin“ ensure_path “HOME/\.local/bin" if \! command \-v hermes &\>/dev/null; then red " hermes\-agent installed, but 'hermes' is not on PATH in this shell\." yellow " Open a new shell \(or: source ~/\.bashrc / ~/\.zshrc\) and re\-run:" yellow " curl \-fsSL https://hermes\-workspace\.com/install\.sh \| bash" exit 1 fi green " hermes\-agent installed ✓ \((command -v hermes))” fi # ─── clone workspace ────────────────────────────────────────────────────── cyan “→ Cloning hermes-workspace…” if [[ -d “$INSTALL_DIR” ]]; then yellow “ INSTALL\_DIR exists; pulling latest" git \-C "INSTALL_DIR“ pull --ff-only else git clone “REPO\_URL" "INSTALL_DIR” fi cd “$INSTALL_DIR” green “ Workspace ready at INSTALL\_DIR ✓" \# ─── env \+ install ──────────────────────────────────────────────────────── cyan "→ Configuring \.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 ready ✓“ cyan “→ Installing npm deps (pnpm install)…” pnpm install --silent green “ deps installed ✓“ # ─── seed Hermes skills (Conductor needs workspace-dispatch) ───────────── cyan “→ Linking bundled skills into ~/.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 “ linked $skill_name ✓“ || true done fi # ─── done ───────────────────────────────────────────────────────────────── bold “” bold “━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━” green “ Install complete!“ bold “━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━” cat <