hermes-launch 1.0.0 → 1.1.0

package/bin/hermes-launch.js

@@ -10,34 +10,42 @@
  */
 
 import { execSync, spawn } from 'child_process';
-import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
-import { homedir, platform, hostname } from 'os';
+import { readFileSync, existsSync } from 'fs';
+import { homedir, platform as osPlatform } from 'os';
 import { resolve } from 'path';
 import { createInterface } from 'readline';
 
-const HERMES_HOME = resolve(homedir(), '.hermes');
+const PLATFORM = osPlatform();                     // win32, darwin, linux
+const IS_WIN = PLATFORM === 'win32';
+const IS_MAC = PLATFORM === 'darwin';
+const IS_LINUX = PLATFORM === 'linux';
+
+const HERMES_HOME = IS_WIN
+  ? resolve(process.env.USERPROFILE || homedir(), '.hermes')
+  : resolve(homedir(), '.hermes');
 const CONFIG_PATH = resolve(HERMES_HOME, 'config.yaml');
 const INSTALL_URL = 'https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh';
 
-const BOLD = '\x1b[1m';
-const DIM = '\x1b[2m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const RED = '\x1b[31m';
-const CYAN = '\x1b[36m';
-const RESET = '\x1b[0m';
-const CLEAR_LINE = '\x1b[K';
+// Windows: node strips ansi codes in cmd/powershell by default, but keep for
+// terminals that support them (Windows Terminal, VS Code terminal, etc.)
+const USE_COLOR = !IS_WIN || (process.env.TERM_PROGRAM || '').includes('vscode') || process.env.WT_SESSION;
+const BOLD = USE_COLOR ? '\x1b[1m' : '';
+const DIM = USE_COLOR ? '\x1b[2m' : '';
+const GREEN = USE_COLOR ? '\x1b[32m' : '';
+const YELLOW = USE_COLOR ? '\x1b[33m' : '';
+const RED = USE_COLOR ? '\x1b[31m' : '';
+const CYAN = USE_COLOR ? '\x1b[36m' : '';
+const RESET = USE_COLOR ? '\x1b[0m' : '';
 
 // ——— helpers ———
 
 function printBanner() {
-  const banner = `
-  ╔════════════════════════════════════════╗
-  ║  ${CYAN}🐚  Hermes Launch  ${RESET}              ║
-  ║  ${DIM}zero-to-AI-agent in seconds${RESET}       ║
-  ╚════════════════════════════════════════╝
-  `;
-  console.log(banner);
+  console.log(`
+  ${CYAN}╔════════════════════════════════════════╗${RESET}
+  ${CYAN}║${RESET}  🐚  Hermes Launch                  ${CYAN}║${RESET}
+  ${CYAN}║${RESET}  ${DIM}zero-to-AI-agent in seconds${RESET}       ${CYAN}║${RESET}
+  ${CYAN}╚════════════════════════════════════════╝${RESET}
+  `);
 }
 
 function ask(query) {
@@ -46,7 +54,12 @@ function ask(query) {
 }
 
 function run(cmd, opts = {}) {
-  const defaults = { stdio: opts.silent ? 'pipe' : 'inherit', timeout: 120_000, ...opts };
+  const defaults = {
+    stdio: opts.silent ? 'pipe' : 'inherit',
+    timeout: 120_000,
+    shell: IS_WIN ? true : false,         // Windows needs shell for PATH resolution
+    ...opts,
+  };
   try {
     const out = execSync(cmd, defaults);
     return { ok: true, out: out?.toString()?.trim() || '' };
@@ -55,6 +68,11 @@ function run(cmd, opts = {}) {
   }
 }
 
+function runPwsh(cmd, opts = {}) {
+  // Run a PowerShell command — used on Windows for winget, etc.
+  return run(`powershell -NoProfile -Command "${cmd}"`, opts);
+}
+
 function spinner(ms) {
   return new Promise(resolve => setTimeout(resolve, ms));
 }
@@ -80,7 +98,6 @@ function printSummary(info) {
   console.log(`    ${CYAN}hermes model${RESET}         change model/provider`);
   console.log(`    ${CYAN}hermes gateway setup${RESET}  connect Telegram/Discord`);
   console.log(`    ${CYAN}hermes tools list${RESET}     see available tools`);
-  console.log(`    ${CYAN}hermes cron${RESET}           schedule recurring tasks`);
   console.log(`    ${CYAN}hermes doctor${RESET}         health check\n`);
   console.log(`  ${BOLD}Docs${RESET}`);
   console.log(`    ${CYAN}https://hermes-agent.nousresearch.com/docs${RESET}\n`);
@@ -91,66 +108,226 @@ function printSummary(info) {
     }
     console.log();
   }
+  if (info.windowsNote) {
+    console.log(`  ${YELLOW}${info.windowsNote}${RESET}\n`);
+  }
 }
 
-function printMiniBanner() {
-  console.log(`
-  ${CYAN}  🐚  Hermes Launch${RESET}  ${DIM}— zero-to-agent${RESET}
-  `);
+// ——— platform detection ———
+
+function detectPackageManager() {
+  if (IS_WIN) {
+    // winget ships with Windows 11 and recent Win10
+    if (run('winget --version', { silent: true }).ok) return 'winget';
+    if (run('choco --version', { silent: true }).ok) return 'choco';
+    if (run('scoop --version', { silent: true }).ok) return 'scoop';
+    return null;
+  }
+  if (IS_MAC) {
+    if (run('brew --version', { silent: true }).ok) return 'brew';
+    return null;
+  }
+  // Linux
+  if (run('apt-get --version', { silent: true }).ok) return 'apt';
+  if (run('dnf --version', { silent: true }).ok) return 'dnf';
+  if (run('pacman --version', { silent: true }).ok) return 'pacman';
+  return null;
 }
 
-// ——— core steps ———
+function winHasWsl() {
+  return run('wsl --version', { silent: true }).ok || run('wsl -l', { silent: true }).ok;
+}
 
-async function checkPrereqs() {
-  const s = step('Checking prerequisites');
-  const checks = {
-    node: run('node --version', { silent: true }).ok,
-    python3: run('python3 --version', { silent: true }).ok,
-    curl: run('curl --version', { silent: true }).ok,
-    git: run('git --version', { silent: true }).ok,
-  };
+// ——— prerequisite checks + auto-install ———
 
-  const missing = Object.entries(checks).filter(([, ok]) => !ok).map(([name]) => name);
-  if (missing.length) {
-    s.fail(`Missing: ${missing.join(', ')}`);
-    console.log(`  Install missing tools and try again.`);
-    process.exit(1);
-  }
+async function checkPython() {
+  // Windows uses "python" and "py", not "python3"
+  const pyCandidates = IS_WIN
+    ? ['python', 'py -3', 'python3']
+    : ['python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10', 'python3'];
 
-  // Check Python version >= 3.10 — try multiple binaries
-  const pyCandidates = ['python3.11', 'python3.12', 'python3.13', 'python3.14', 'python3.10', 'python3'];
-  let pyVer = '';
-  let pyBin = 'python3';
   for (const bin of pyCandidates) {
     const r = run(`${bin} --version`, { silent: true });
     if (r.ok) {
-      pyVer = r.out;
-      pyBin = bin;
-      break;
+      const match = r.out.match(/(\d+)\.(\d+)/);
+      if (match) {
+        const major = parseInt(match[1]), minor = parseInt(match[2]);
+        if (major >= 3 && minor >= 10) {
+          return { ok: true, bin, version: `${major}.${minor}` };
+        }
+      }
+    }
+  }
+  return { ok: false, bin: null, version: null };
+}
+
+async function installPython(pkgMan) {
+  const s = step('Installing Python 3.12+');
+  try {
+    if (IS_WIN) {
+      if (pkgMan === 'winget') {
+        const r = runPwsh('winget install --accept-source-agreements --accept-package-agreements Python.Python.3.12', { timeout: 180_000 });
+        if (!r.ok) throw new Error(r.out);
+      } else if (pkgMan === 'choco') {
+        run('choco install python --yes', { timeout: 180_000 });
+      } else if (pkgMan === 'scoop') {
+        run('scoop install python', { timeout: 180_000 });
+      } else {
+        s.fail('No package manager found. Install Python from https://python.org');
+        return false;
+      }
+      // Refresh PATH so we can find python immediately
+      process.env.PATH = `${process.env.USERPROFILE}\\AppData\\Local\\Programs\\Python\\Python312\\;${process.env.USERPROFILE}\\AppData\\Local\\Programs\\Python\\Python312\\Scripts\\;${process.env.PATH}`;
+    } else if (IS_MAC) {
+      run('brew install python@3.12', { timeout: 180_000 });
+      // brew python3.12 is often keg-only — symlink or use full path
+      run('brew link --overwrite python@3.12', { silent: true, timeout: 30_000 });
+    } else {
+      // Linux
+      if (pkgMan === 'apt') {
+        run('apt-get update -qq && apt-get install -y python3 python3-pip python3-venv', { timeout: 180_000 });
+      } else if (pkgMan === 'dnf') {
+        run('dnf install -y python3 python3-pip', { timeout: 180_000 });
+      } else if (pkgMan === 'pacman') {
+        run('pacman -S --noconfirm python python-pip', { timeout: 180_000 });
+      }
+    }
+    s.ok();
+    return true;
+  } catch (e) {
+    s.fail(e.message);
+    return false;
+  }
+}
+
+async function checkCurl() {
+  const candidates = IS_WIN ? ['curl.exe', 'curl'] : ['curl'];
+  for (const bin of candidates) {
+    if (run(`${bin} --version`, { silent: true }).ok) return { ok: true, bin };
+  }
+  return { ok: false, bin: null };
+}
+
+async function installCurl(pkgMan) {
+  const s = step('Installing curl');
+  try {
+    if (IS_WIN) {
+      // Windows 10+ has curl.exe built-in. If missing, use winget.
+      if (pkgMan === 'winget') {
+        runPwsh('winget install --accept-source-agreements cURL.cURL', { timeout: 120_000 });
+      } else if (pkgMan === 'choco') {
+        run('choco install curl --yes', { timeout: 120_000 });
+      }
+    } else {
+      // macOS/Linux — curl should be present but just in case
+      run('command -v curl || (apt-get install -y curl 2>/dev/null || yum install -y curl 2>/dev/null)', { timeout: 120_000 });
     }
+    s.ok();
+    return true;
+  } catch (e) {
+    s.fail(e.message);
+    return false;
   }
+}
+
+async function checkGit() {
+  const candidates = IS_WIN ? ['git.exe', 'git'] : ['git'];
+  for (const bin of candidates) {
+    if (run(`${bin} --version`, { silent: true }).ok) return { ok: true, bin };
+  }
+  return { ok: false, bin: null };
+}
 
-  const match = pyVer.match(/(\d+)\.(\d+)/);
-  if (match) {
-    const major = parseInt(match[1]), minor = parseInt(match[2]);
-    if (major < 3 || (major === 3 && minor < 10)) {
-      s.fail(`Python 3.10+ required, got ${major}.${minor} (${pyBin})`);
+async function installGit(pkgMan) {
+  const s = step('Installing git');
+  try {
+    if (IS_WIN) {
+      if (pkgMan === 'winget') {
+        runPwsh('winget install --accept-source-agreements --accept-package-agreements Git.Git', { timeout: 180_000 });
+      } else if (pkgMan === 'choco') {
+        run('choco install git --yes', { timeout: 180_000 });
+      } else if (pkgMan === 'scoop') {
+        run('scoop install git', { timeout: 180_000 });
+      }
+    } else {
+      run('command -v git || (apt-get install -y git 2>/dev/null || brew install git 2>/dev/null)', { timeout: 120_000 });
+    }
+    s.ok();
+    return true;
+  } catch (e) {
+    s.fail(e.message);
+    return false;
+  }
+}
+
+async function checkPrereqs() {
+  const s = step('Checking prerequisites');
+
+  const pkgMan = detectPackageManager();
+
+  // 1. Python
+  const py = await checkPython();
+  if (!py.ok) {
+    if (pkgMan) {
+      process.stdout.write(`\n`);
+      const installed = await installPython(pkgMan);
+      if (!installed) {
+        process.exit(1);
+      }
+    } else {
+      s.fail('Python 3.10+ is required but not found');
+      if (IS_WIN) {
+        console.log(`  ${YELLOW}Install: https://python.org or run: winget install Python.Python.3.12${RESET}`);
+      } else if (IS_MAC) {
+        console.log(`  ${YELLOW}Install: brew install python@3.12${RESET}`);
+      } else {
+        console.log(`  ${YELLOW}Install: sudo apt install python3 python3-pip python3-venv${RESET}`);
+      }
+      process.exit(1);
+    }
+  }
+
+  // 2. curl
+  const curlCheck = await checkCurl();
+  if (!curlCheck.ok) {
+    if (pkgMan) {
+      await installCurl(pkgMan);
+    } else {
+      s.fail('curl is required');
+      process.exit(1);
+    }
+  }
+
+  // 3. git
+  const gitCheck = await checkGit();
+  if (!gitCheck.ok) {
+    if (pkgMan) {
+      await installGit(pkgMan);
+    } else {
+      s.fail('git is required');
       process.exit(1);
     }
   }
 
   s.ok();
-  checks.pythonBin = pyBin;
-  return checks;
+  return { ...py, pkgMan, curlBin: curlCheck.bin || '', gitBin: gitCheck.bin || '' };
 }
 
-async function installHermes(quick) {
+// ——— Hermes install ———
+
+async function installHermes(quick, platformInfo) {
   const s = step('Checking Hermes installation');
-  const hasHermes = run('hermes --version', { silent: true }).ok;
 
-  if (hasHermes) {
-    const ver = run('hermes --version', { silent: true }).out;
-    s.skip(`v${ver} already installed`);
+  // On Windows, try both "hermes" and "hermes.exe"
+  const hermesCheck = IS_WIN
+    ? (run('hermes --version', { silent: true }).ok || run('hermes.exe --version', { silent: true }).ok)
+    : run('hermes --version', { silent: true }).ok;
+
+  if (hermesCheck) {
+    const ver = run('hermes --version', { silent: true }).ok
+      ? run('hermes --version', { silent: true }).out
+      : 'installed';
+    s.skip(`${ver} already installed`);
     return true;
   }
 
@@ -158,27 +335,71 @@ async function installHermes(quick) {
     console.log();
     const ans = await ask(`  Hermes not found. Install it now? [Y/n] `);
     if (ans.toLowerCase() === 'n') {
-      console.log(`  ${YELLOW}Aborted. Install manually: curl -fsSL ${INSTALL_URL} | bash${RESET}`);
+      console.log(`  ${YELLOW}Aborted.${RESET}`);
       process.exit(0);
     }
   }
 
   const si = step('Downloading and installing Hermes');
-  try {
-    const cmd = `curl -fsSL ${INSTALL_URL} | bash`;
-    const result = run(cmd, { timeout: 180_000, silent: false });
-    if (!result.ok) {
-      si.fail(result.out);
+
+  if (IS_WIN) {
+    // Windows: install via pip (the bash script won't work without WSL)
+    try {
+      // Ensure pip is available
+      const pyBin = platformInfo.bin || 'python';
+      run(`${pyBin} -m pip install --upgrade pip`, { silent: true, timeout: 60_000 });
+
+      const r = run(`${pyBin} -m pip install hermes-agent`, { timeout: 180_000 });
+      if (!r.ok) throw new Error(r.out);
+
+      // After pip install, check if "hermes" command is available
+      // On Windows, scripts may be in %APPDATA%\Python\Scripts or %USERPROFILE%\.local\bin
+      const pathsToAdd = [
+        resolve(process.env.APPDATA || '', 'Python', 'Scripts'),
+        resolve(homedir(), '.local', 'bin'),
+      ];
+      for (const p of pathsToAdd) {
+        if (!process.env.PATH?.includes(p)) {
+          process.env.PATH = `${p};${process.env.PATH}`;
+        }
+      }
+
+      si.ok();
+      return true;
+    } catch (e) {
+      // If pip fails, suggest WSL which is the recommended path
+      si.fail(e.message);
+      if (winHasWsl()) {
+        console.log(`\n  ${YELLOW}Pip install failed. Try installing inside WSL instead:${RESET}`);
+        console.log(`    ${CYAN}wsl -d Ubuntu -e bash -c "curl -fsSL ${INSTALL_URL} | bash"${RESET}\n`);
+      } else {
+        console.log(`\n  ${YELLOW}Install WSL + Ubuntu, then run this inside WSL:${RESET}`);
+        console.log(`    ${CYAN}curl -fsSL ${INSTALL_URL} | bash${RESET}`);
+        console.log(`  ${YELLOW}Or install WSL first:${RESET}`);
+        console.log(`    ${CYAN}wsl --install${RESET}\n`);
+      }
+      process.exit(1);
+    }
+  } else {
+    // macOS / Linux
+    try {
+      const cmd = `curl -fsSL ${INSTALL_URL} | bash`;
+      const result = run(cmd, { timeout: 180_000, silent: false });
+      if (!result.ok) {
+        si.fail(result.out);
+        process.exit(1);
+      }
+      si.ok();
+      return true;
+    } catch (e) {
+      si.fail(e.message);
       process.exit(1);
     }
-    si.ok();
-    return true;
-  } catch (e) {
-    si.fail(e.message);
-    process.exit(1);
   }
 }
 
+// ——— config ———
+
 async function checkConfig(quick) {
   const s = step('Checking Hermes configuration');
 
@@ -204,17 +425,15 @@ async function checkConfig(quick) {
 async function runSetup(quick) {
   if (quick) {
     const s = step('Running headless setup');
-    // For quick mode, just enable the gateway and set up with defaults
     const setCmds = [
-      'hermes tools enable web terminal file skills session_search delegate_task memory clarify vision 2>/dev/null || true',
-      `hermes config set display.streaming.enabled true 2>/dev/null || true`,
+      'hermes tools enable web terminal file skills session_search delegate_task memory clarify vision 2>/dev/null || ver>nul',
+      `hermes config set display.streaming.enabled true 2>/dev/null || cmd /c ver>nul`,
     ];
     for (const cmd of setCmds) run(cmd, { silent: true });
     s.ok();
     return;
   }
 
-  // Interactive: guide the user through setup
   console.log(`\n  ${BOLD}Let's configure your Hermes Agent.${RESET}\n`);
   console.log(`  ${DIM}(You can skip any step and configure later with \`hermes setup\`)${RESET}\n`);
 
@@ -223,18 +442,14 @@ async function runSetup(quick) {
     const s = step('Running setup wizard');
     try {
       const result = run('hermes setup', { stdio: 'inherit', timeout: 300_000 });
-      if (!result.ok) {
-        s.fail(result.out);
-      } else {
-        s.ok();
-      }
+      if (!result.ok) s.fail(result.out);
+      else s.ok();
     } catch (e) {
       s.fail(e.message);
     }
   } else {
-    // Minimal quick config
     const s = step('Applying minimal configuration');
-    run('hermes tools enable web terminal file skills session_search delegate_task memory 2>/dev/null || true', { silent: true });
+    run('hermes tools enable web terminal file skills session_search delegate_task memory 2>/dev/null || ver>nul', { silent: true });
     s.skip('minimal config applied');
   }
 }
@@ -242,43 +457,25 @@ async function runSetup(quick) {
 async function enableToolsets(quick) {
   const s = step('Enabling tool sets');
 
-  // Core toolsets that make Hermes useful
-  const toolsets = [
-    'web',           // web search + content extraction
-    'terminal',      // shell commands
-    'file',          // file read/write/search
-    'skills',        // skill management
-    'session_search', // cross-session recall
-    'delegate_task', // spawn subagents
-    'memory',        // cross-session memory
-    'vision',        // image analysis
-    'tts',           // text-to-speech
-    'clarify',       // ask questions
-  ];
-
-  let ok = true;
-  for (const t of toolsets) {
-    const r = run(`hermes tools enable ${t}`, { silent: true });
-    if (!r.ok) ok = false;
-  }
+  const toolsets = ['web', 'terminal', 'file', 'skills', 'session_search', 'delegate_task', 'memory', 'vision', 'tts', 'clarify'];
 
-  if (ok) {
-    s.ok();
-  } else {
-    // Some may have failed if already enabled — that's fine
-    s.ok();
+  // Windows: hermes commands use shell redirect
+  const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
+  for (const t of toolsets) {
+    run(`hermes tools enable ${t} ${noop}`, { silent: true });
   }
 
-  // Enable gateway streaming
-  run('hermes config set display.streaming.enabled true 2>/dev/null || true', { silent: true });
+  run(`hermes config set display.streaming.enabled true ${noop}`, { silent: true });
+  s.ok();
 }
 
 async function startDashboard(quick) {
   const s = step('Starting web dashboard');
-  const port = quick ? '9119' : '9119';
+  const port = '9119';
+
+  const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
 
-  // Check if dashboard is already running
-  const statusCheck = run('hermes dashboard --status', { silent: true });
+  const statusCheck = run(`hermes dashboard --status ${noop}`, { silent: true });
   if (statusCheck.ok && statusCheck.out.length > 0 && !statusCheck.out.includes('No running')) {
     s.skip('already running');
     return { port, alreadyRunning: true };
@@ -291,15 +488,16 @@ async function startDashboard(quick) {
       {
         stdio: 'inherit',
         detached: false,
+        shell: IS_WIN,
         env: { ...process.env },
       }
     );
 
-    // Give it a moment to start
     await spinner(3000);
 
-    // Verify it's up
-    const verify = run(`curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:${port}/ 2>/dev/null || echo "0"`, { silent: true });
+    // Verify — use curl or curl.exe
+    const curlBin = IS_WIN ? 'curl.exe -s -o nul -w "%{http_code}"' : 'curl -s -o /dev/null -w "%{http_code}"';
+    const verify = run(`${curlBin} http://127.0.0.1:${port}/ 2>/dev/null || echo 0`, { silent: true });
     if (verify.out === '0') {
       s.skip('dashboard launched in background');
     } else {
@@ -315,7 +513,8 @@ async function startDashboard(quick) {
 
 async function checkGatewayStatus() {
   const s = step('Checking messaging gateway');
-  const result = run('hermes gateway status', { silent: true });
+  const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
+  const result = run(`hermes gateway status ${noop}`, { silent: true });
   if (result.ok) {
     const out = result.out;
     const hasTelegram = out.includes('telegram') && (out.includes('running') || out.includes('connected'));
@@ -332,27 +531,6 @@ async function checkGatewayStatus() {
   return [];
 }
 
-async function showQuickStart() {
-  console.log(`\n  ${BOLD}${GREEN}Hermes Agent is ready to use!${RESET}\n`);
-
-  console.log(`  ${BOLD}Start a conversation:${RESET}`);
-  console.log(`    ${CYAN}hermes${RESET}                    interactive chat`);
-  console.log(`    ${CYAN}hermes -q "summarize my repo"${RESET}  one-shot query\n`);
-
-  console.log(`  ${BOLD}First things to try:${RESET}`);
-  console.log(`    • ${CYAN}hermes model${RESET} — pick your LLM provider`);
-  console.log(`    • ${CYAN}hermes gateway setup${RESET} — connect Telegram/Discord`);
-  console.log(`    • ${CYAN}hermes dashboard${RESET} — open the web UI`);
-  console.log(`    • ${CYAN}hermes skills browse${RESET} — discover skills\n`);
-
-  console.log(`  ${BOLD}Pro tips:${RESET}`);
-  console.log(`    • ${DIM}Your config lives at ~/.hermes/config.yaml${RESET}`);
-  console.log(`    • ${DIM}API keys go in ~/.hermes/.env${RESET}`);
-  console.log(`    • ${DIM}Type /help in a session for all slash commands${RESET}`);
-  console.log(`    • ${DIM}Run \`hermes doctor\` if something isn't working${RESET}`);
-  console.log();
-}
-
 // ——— main ———
 
 async function main() {
@@ -376,16 +554,24 @@ async function main() {
 
   ${BOLD}What it does:${RESET}
     1. Check prerequisites (Python, curl, git)
-    2. Install Hermes Agent (if not present)
-    3. Run setup wizard to configure model/tools
-    4. Enable useful toolsets
-    5. Start the web dashboard on port 9119
-    6. Print next steps
+    2. Install missing dependencies automatically
+    3. Install Hermes Agent (if not present)
+    4. Run setup wizard to configure model/tools
+    5. Enable useful toolsets
+    6. Start the web dashboard on port 9119
+    7. Print next steps
 
   ${BOLD}After launch:${RESET}
     hermes              start chatting
     hermes gateway setup  add Telegram/Discord
     hermes model        change AI provider
+
+  ${BOLD}Windows notes:${RESET}
+    - Python is auto-installed via winget (or choco/scoop) if missing
+    - Recommended: use Windows Terminal for best experience
+    - For full functionality, WSL2 is recommended:
+      wsl --install -d Ubuntu
+      Then run: npx hermes-launch inside WSL
     `);
     process.exit(0);
   }
@@ -397,11 +583,8 @@ async function main() {
   }
 
   if (flags.dashboard) {
-    printMiniBanner();
     const result = await startDashboard(true);
-    if (result.error) {
-      process.exit(1);
-    }
+    if (result.error) process.exit(1);
     printSummary({ port: result.port, messaging: {} });
     process.exit(0);
   }
@@ -409,11 +592,15 @@ async function main() {
   // ——— full flow ———
   printBanner();
 
-  // 1. Prerequisites
-  await checkPrereqs();
+  if (IS_WIN) {
+    console.log(`  ${DIM}Windows detected — auto-installing missing deps${RESET}\n`);
+  }
+
+  // 1. Prerequisites (auto-installs Python, git, curl if missing)
+  const platformInfo = await checkPrereqs();
 
-  // 2. Install
-  await installHermes(flags.quick);
+  // 2. Install Hermes
+  await installHermes(flags.quick, platformInfo);
 
   // 3. Check config
   const needsSetup = await checkConfig(flags.quick);
@@ -433,12 +620,18 @@ async function main() {
   const platforms = await checkGatewayStatus();
 
   // 8. Show summary
-  printSummary({
+  const summary = {
     port: dashResult.port,
     messaging: platforms.length > 0
       ? Object.fromEntries(platforms.map(p => [p, `${GREEN}connected${RESET}`]))
       : { none: `${YELLOW}not configured${RESET} (run \`hermes gateway setup\`)` },
-  });
+  };
+
+  if (IS_WIN) {
+    summary.windowsNote = 'On Windows, some tools work best in WSL2. Run `wsl --install -d Ubuntu` for the full experience.';
+  }
+
+  printSummary(summary);
 }
 
 main().catch(e => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermes-launch",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "One command to launch Hermes Agent — zero-to-AI-agent in seconds",
   "bin": {
     "hermes-launch": "./bin/hermes-launch.js"