shawn
2b7a8290a5
- New start-windows-mcp.bat — starts Windows-MCP SSE server on :8000 - Windows-MCP auto-starts when Hermes CLI launches (options 1/2) - Pre-downloaded wheels: hermes-agent (47), windows-mcp (95) - Offline Python 3.13 embedded + get-pip.py bootstrapper - Hermes config wired with mcp_servers.windows-mcp - Updated Makefile with targets: wheels-hermes, wheels-windows-mcp, python-portable, get-pip, deps - Recreated: run-hermes.ps1, start-hermes-dashboard.bat - Pure ASCII .bat files with CRLF line endings
70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
# 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:
|
|
1. Boot → launch Hermes agent
|
|
2. Agent detects the problem space (BSOD? Won't boot? Hardware failure?)
|
|
3. Chains diagnostics: RAM first, then disk, then CPU/GPU
|
|
4. Interprets all results together
|
|
5. Suggests or executes fixes
|
|
6. 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
|