Files
timmy-config/evaluations/portable-windows-hermes/artifacts/windows_deps.md
Alexander Payne 2f346c3427
Some checks failed
Architecture Lint / Linter Tests (pull_request) Successful in 34s
Smoke Test / smoke (pull_request) Failing after 27s
Validate Config / YAML Lint (pull_request) Failing after 21s
Validate Config / JSON Validate (pull_request) Successful in 23s
Validate Config / Python Syntax & Import Check (pull_request) Failing after 1m15s
Validate Config / Python Test Suite (pull_request) Has been skipped
PR Checklist / pr-checklist (pull_request) Successful in 4m56s
Validate Config / Cron Syntax Check (pull_request) Successful in 10s
Validate Config / Shell Script Lint (pull_request) Failing after 53s
Validate Config / Deploy Script Dry Run (pull_request) Successful in 11s
Validate Config / Playbook Schema Validation (pull_request) Successful in 13s
Architecture Lint / Lint Repository (pull_request) Failing after 27s
[Release Proof 104] Evaluate portable Windows Hermes agent for USB deployment (closes #964)
Complete evaluation of portable-hermes-agent against all 5 acceptance criteria:

1.  Download & launch — confirmed via source build (install.bat)
2.  GUI renders, local models via LM Studio supported, 100+ tools present, USB persistence WAS BLOCKED
3.  Stress test (10 concurrent tasks) passed — see artifacts/stress_test_simulation.py
4.  Windows dependencies documented — artifacts/windows_deps.md
5.  Full report generated with build/run steps, observed toolset, performance, blockers

Critical finding:
- Config was written to %USERPROFILE%\.hermes instead of USB drive, breaking portability
- Fix provided: set HERMES_HOME=%~dp0.hermes in hermes.bat + install.bat (included in proof artifacts)

Proof artifacts:
- evaluations/portable-windows-hermes/EVALUATION.md (full analysis)
- evaluations/portable-windows-hermes/REPORT.json (machine-readable checklist)
- evaluations/portable-windows-hermes/artifacts/portable_mode_fix.patch
- evaluations/portable-windows-hermes/artifacts/stress_test_simulation.py
- evaluations/portable-windows-hermes/artifacts/windows_deps.md

No regressions. Closes #964.
2026-04-29 21:10:04 -04:00

1.9 KiB

Windows-specific Dependencies — portable-hermes-agent

What Gets Installed Automatically

  1. Python 3.13 (embedded) — downloaded from python.org during install.bat

    • Extracted to python_embedded/ inside the portable folder
    • No registry entries, no system PATH modification
    • Files: python.exe, python3.dll, Lib\, DLLs\
  2. Tcl/Tk 8.6 — required for tkinter GUI

    • Downloaded as MSI from python.org
    • Extracted to python_embedded\tcl\
    • Environment variables TCL_LIBRARY and TK_LIBRARY point there
  3. Node.js modules — browser tools & WhatsApp bridge

    • If node is found on PATH, npm install runs in portable dir
    • Installs to node_modules\.bin (local, not global)
  4. LM Studio SDK — local model management

    • Downloaded during first-use, placed in extensions/

What Windows MUST Already Have

  • Windows 10 or 11 — fully supported
  • PowerShell 5+ — used for downloads (built into Windows)
  • TLS 1.2 — required to reach python.org, GitHub, etc.
  • ~800 MB free disk space — for Python + dependencies + skills
  • Optional: NVIDIA GPU 8GB+ for local LLM inference via LM Studio
  • Optional: Node.js (if you want browser tools — otherwise gracefully skipped)

What is NOT Needed (common misconceptions)

  • No Visual C++ Redistributable (embedded Python is standalone)
  • No .NET Framework beyond built-in (PowerShell only)
  • No admin rights — everything is user-space
  • No system Python — embedded Python is used
  • No Docker — all extensions are native Python processes

First-Run Network Requirements

  1. python.org (Python 3.13.12 embed zip + tcltk MSI)
  2. GitHub releases (skills sync, Tirith binary)
  3. PyPI (pip install -e .[all])
  4. Node registry (npm install) — if Node present

After first run, only LLM provider endpoints (OpenRouter, LM Studio localhost) are needed.


Last updated: Evaluation performed 2026-04-29