shawn
ecda528b90
Build scripts, configuration, and launch scripts for the Hermes Portable Rescue runtime. Includes: - build-hermes-runtime.sh — Main build script (venv, config, tools) - bootstrap-venv.sh — Standalone Python venv builder - config.yaml — Agent configuration for rescue mode - launch.sh/launch.ps1 — Linux and Windows entry points - agent/hermes — Entry point for autorun.sh compatibility - tool-manifest.json — Tool registry for diagnostic binaries - scripts/ — check-env.sh, mount-storage.sh helpers - autorun.inf — Windows USB auto-launch - README — Build and runtime documentation Part of the Hermes Portable Rescue project board. Task: t_c816e37d
Hermes Portable Rescue — Source & Build
This directory contains the build scripts and source files for the Hermes Portable Rescue USB runtime.
Files
| File | Purpose |
|---|---|
build-hermes-runtime.sh |
Main build script — creates the portable Hermes runtime package |
bootstrap-venv.sh |
Standalone venv bootstrap (can run on target machine) |
autorun.inf |
Windows USB autorun configuration |
hermes/config.yaml |
Hermes Agent configuration for rescue mode |
hermes/launch.sh |
Linux launch script |
hermes/launch.ps1 |
Windows PowerShell launch script |
hermes/tool-manifest.json |
Tool registry for the agent |
hermes/scripts/check-env.sh |
Environment verification script |
hermes/scripts/mount-storage.sh |
Storage partition mounting helper |
hermes/README.md |
Runtime package documentation (for the USB) |
Building
# From the project root:
./src/build-hermes-runtime.sh
# Or with custom output path:
./src/build-hermes-runtime.sh --output /mnt/usb/hermes
The build script:
- Creates the directory structure
- Copies configuration files from
src/hermes/ - Creates a Python 3.11 virtual environment with Hermes Agent
- Installs dependencies (pyyaml, psutil, requests)
- Prunes the venv to reduce size
- Collects diagnostic tool binaries
- Generates the tool manifest and launch scripts
Output
After building, src/hermes/ contains the complete portable runtime:
hermes/
├── venv/ ← Python 3.11 + Hermes Agent (60-80 MB)
├── config.yaml ← Agent configuration
├── launch.sh ← Linux entry point
├── launch.ps1 ← Windows entry point
├── tool-manifest.json ← Tool registry
├── tools/ ← Diagnostic binaries
├── scripts/ ← Helper scripts
├── pip-freeze.txt ← Installed package manifest
└── README.md ← Runtime docs
Copy the entire hermes/ directory to your USB drive and run ./launch.sh.