shawn
14cf8332a2
- start-llama-server.bat: fix LLAMA_DIR to bin\llama (was bin\ollama), fix model to qwen2.5-coder-1.5b (was Llama-3.2-1B), use correct GPU (llama-server.exe) and CPU (cpu\llama-server-cpu.exe) binaries - start-windows-mcp.bat: remove dead python313\ tier, use single embedded Python 3.13 at python\python.exe - run-hermes.bat: use Scripts\hermes.exe instead of -m hermes_cli (no __main__.py in package), fix offline mode to use single config.yaml instead of non-existent config.offline.yaml - run-hermes.ps1: same hermes_cli → hermes.exe fix - README.txt: update to match actual USB state (Python 3.13, 142 wheels, Qwen2.5-Coder-1.5B 1117MB model, correct dir structure)
Hermes Portable Rescue
An autonomous AI-driven Windows PC diagnostic & repair toolkit that lives on a USB drive. Boot any Windows PC from this USB and Hermes Agent takes over — diagnosing BSODs, testing hardware, updating drivers, and handling backup/restore — all with LLM-powered reasoning.
What it does
| Capability | How |
|---|---|
| 🔍 BSOD Analysis | Parses minidumps, interprets stop codes with LLM, correlates with known fixes |
| 💾 RAM Test | Auto-runs MemTest86+/stress tests and interprets results |
| 🔥 CPU/GPU Diagnostics | Stress testing, thermal monitoring, benchmark comparison |
| 🖴 Disk Health | SMART analysis (smartmontools), bad sector scan, S.M.A.R.T. attribute interpretation |
| ⬆️ Driver Updates | Hardware inventory → vendor API lookup → guided download/install |
| 📦 Backup/Restore | Disk imaging, file-level backup, guided restore with AI oversight |
| 💬 Natural Language | Describes what it found and what it's doing — no manual tool hunting |
| 🖱️ Windows UI Automation | Hermes can click, type, take screenshots, and navigate Windows UI via Windows-MCP (option 6) |
Why this is different from existing tools
Existing USB rescue tools (Hiren's BootCD PE, Medicat, SystemRescue, 2k10 Live WinPE, S.A.K. Utility) are static tool collections. You boot in, know which tool to run, interpret results yourself.
Hermes Portable Rescue is an agent — it thinks through problems the way a senior tech would:
- Boot → launch Hermes agent
- Agent detects the problem space (BSOD? Won't boot? Hardware failure?)
- Chains diagnostics: RAM first, then disk, then CPU/GPU
- Interprets all results together
- Suggests or executes fixes
- Documents everything
Architecture
USB Drive
├── boot/ — Bootable ISO or Ventoy config
├── hermes/ — Portable Hermes Agent runtime
│ ├── agent/ — Hermes core
│ ├── tools/ — Portable diagnostic executables
│ │ ├── smartmontools/
│ │ ├── memtest86+/
│ │ ├── prime95/ (or equivalent)
│ │ └── ...
│ ├── models/ — LLM model (if local) or API config
│ └── scripts/ — Diagnostic scripts & automation
├── rescue.iso — Bootable rescue environment
└── autorun.inf — Auto-launch on supported systems
Project Structure
~/nas-projects/hermes-portable-rescue/
├── README.md ← This file
├── docs/ — Architecture docs, design decisions
├── research/ — Research findings from Phase 1
├── src/ — Build scripts and source
└── build/ — Build output (ISOs, packages)
Storage
NAS (pve at 192.168.0.144, 3.6TB HDD), mounted via SSHFS at ~/nas-projects/.
Gitea Repo
hermes-portable-rescue at gitea.ourpad.casa
License
AGPL-3.0