# 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