# techjarves/hermes-usb-portable architecture

> Architecture diagram of the GitHub repository techjarves/hermes-usb-portable, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/techjarves/hermes-usb-portable
- Repository: https://github.com/techjarves/hermes-usb-portable

## Overview

Hermes Portable wraps the downloaded Hermes Agent in a cross-platform, folder-local runtime. The user starts the platform launcher; on first run, setup downloads local runtimes, prepares Hermes, and marks setup ready. The launcher then configures an isolated environment and opens a menu for chat or a background gateway. The README also documents private configuration, sessions, memories, and skills, plus support for external model providers and Ollama. The repository contains no source excerpts, so relationships below are based on README statements only.

Main entry points: [`launch.bat`](https://github.com/techjarves/hermes-usb-portable/blob/main/launch.bat) (Windows Launcher), [`launch.sh`](https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh) (Unix Launcher), [`scripts/setup-windows.ps1`](https://github.com/techjarves/hermes-usb-portable/blob/main/scripts/setup-windows.ps1) (Windows Setup), [`scripts/setup-unix.sh`](https://github.com/techjarves/hermes-usb-portable/blob/main/scripts/setup-unix.sh) (Unix Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Portable Bootstrap"]
  node_windows_launcher["Windows Launcher<br/>[launch.bat]"]
  node_unix_launcher["Unix Launcher<br/>[launch.sh]"]
  node_windows_setup["Windows Setup<br/>[setup-windows.ps1]"]
  node_unix_setup["Unix Setup<br/>[setup-unix.sh]"]
  node_portable_runtimes["Portable Runtimes"]
end

subgraph group_execution["Agent Execution"]
  node_hermes_source["Hermes Agent"]
  node_isolated_environment["Isolated Environment<br/>[launch.sh]"]
  node_launcher_menu["Terminal Menu<br/>[launch.sh]"]
  node_chat["Chat"]
  node_gateway["Background Gateway"]
end

subgraph group_state["Local Data"]
  node_user_data[("Private Data")]
end

subgraph group_models["Model Providers"]
  node_model_provider["LLM Provider"]
  node_ollama["Ollama Server"]
end

node_user(("User"))

node_user -->|"starts"| node_windows_launcher
node_user -->|"starts"| node_unix_launcher
node_windows_launcher -->|"runs first setup"| node_windows_setup
node_unix_launcher -->|"runs first setup"| node_unix_setup
node_windows_setup -->|"downloads runtimes"| node_portable_runtimes
node_unix_setup -->|"downloads runtimes"| node_portable_runtimes
node_windows_setup -->|"clones source"| node_hermes_source
node_unix_setup -->|"clones source"| node_hermes_source
node_windows_launcher -->|"configures environment"| node_isolated_environment
node_unix_launcher -->|"configures environment"| node_isolated_environment
node_isolated_environment -->|"prepends paths"| node_portable_runtimes
node_isolated_environment -->|"sets HERMES_HOME"| node_user_data
node_windows_launcher -->|"opens menu"| node_launcher_menu
node_unix_launcher -->|"opens menu"| node_launcher_menu
node_launcher_menu -->|"starts"| node_chat
node_launcher_menu -->|"starts"| node_gateway
node_chat -->|"runs"| node_hermes_source
node_gateway -->|"runs"| node_hermes_source
node_hermes_source -->|"stores locally"| node_user_data
node_hermes_source -.->|"uses configured provider"| node_model_provider
node_hermes_source -.->|"can connect"| node_ollama

click node_windows_launcher "https://github.com/techjarves/hermes-usb-portable/blob/main/launch.bat"
click node_unix_launcher "https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh"
click node_windows_setup "https://github.com/techjarves/hermes-usb-portable/blob/main/scripts/setup-windows.ps1"
click node_unix_setup "https://github.com/techjarves/hermes-usb-portable/blob/main/scripts/setup-unix.sh"
click node_isolated_environment "https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh"
click node_launcher_menu "https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_windows_launcher,node_unix_launcher,node_windows_setup,node_unix_setup,node_portable_runtimes,node_user toneBlue
class node_hermes_source,node_isolated_environment,node_launcher_menu,node_chat,node_gateway toneAmber
class node_user_data toneMint
class node_model_provider,node_ollama toneRose
```

## Components

### Portable Bootstrap

- [Windows Launcher](https://github.com/techjarves/hermes-usb-portable/blob/main/launch.bat): `launch.bat`
- [Unix Launcher](https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh): `launch.sh`
- [Windows Setup](https://github.com/techjarves/hermes-usb-portable/blob/main/scripts/setup-windows.ps1): `scripts/setup-windows.ps1`
- [Unix Setup](https://github.com/techjarves/hermes-usb-portable/blob/main/scripts/setup-unix.sh): `scripts/setup-unix.sh`
- **Portable Runtimes**

### Agent Execution

- **Hermes Agent**
- [Isolated Environment](https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh): `launch.sh`
- [Terminal Menu](https://github.com/techjarves/hermes-usb-portable/blob/main/launch.sh): `launch.sh`
- **Chat**
- **Background Gateway**

### Local Data

- **Private Data**

### Model Providers

- **LLM Provider**
- **Ollama Server**

### Other components

- **User**

## Connections

- User → Windows Launcher: starts (evidence: `README.md`)
- User → Unix Launcher: starts (evidence: `README.md`)
- Windows Launcher → Windows Setup: runs first setup (evidence: `README.md`)
- Unix Launcher → Unix Setup: runs first setup (evidence: `README.md`)
- Windows Setup → Portable Runtimes: downloads runtimes (evidence: `README.md`)
- Unix Setup → Portable Runtimes: downloads runtimes (evidence: `README.md`)
- Windows Setup → Hermes Agent: clones source (evidence: `README.md`)
- Unix Setup → Hermes Agent: clones source (evidence: `README.md`)
- Windows Launcher → Isolated Environment: configures environment (evidence: `README.md`)
- Unix Launcher → Isolated Environment: configures environment (evidence: `README.md`)
- Isolated Environment → Portable Runtimes: prepends paths (evidence: `README.md`)
- Isolated Environment → Private Data: sets HERMES_HOME (evidence: `README.md`)
- Windows Launcher → Terminal Menu: opens menu (evidence: `README.md`)
- Unix Launcher → Terminal Menu: opens menu (evidence: `README.md`)
- Terminal Menu → Chat: starts (evidence: `README.md`)
- Terminal Menu → Background Gateway: starts (evidence: `README.md`)
- Chat → Hermes Agent: runs (evidence: `README.md`)
- Background Gateway → Hermes Agent: runs (evidence: `README.md`)
- Hermes Agent → Private Data: stores locally (evidence: `README.md`)
- Hermes Agent → LLM Provider: uses configured provider (evidence: `README.md`)
- Hermes Agent → Ollama Server: can connect (evidence: `README.md`)
