# stackagen/docker-hermes-agent-setup architecture

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

- Interactive diagram: https://gitdiagram.com/stackagen/docker-hermes-agent-setup
- Repository: https://github.com/stackagen/docker-hermes-agent-setup

## Overview

This repository provides configuration and workspace folders for running Hermes Agent in Docker. The documented workflow is to configure paths and dashboard credentials, start Compose from `.hermes`, then access Hermes through its dashboard, API, or desktop app. Bind-mounted folders provide the coding workspace and Obsidian vaults; agent profiles are loaded through the dashboard. The repository contains setup files, not Hermes implementation code, so runtime internals are not represented.

Main entry points: [`.hermes/compose.yaml`](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml) (Hermes Container), [`.hermes/.env`](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/.env) (Environment Settings), [`coding_space`](https://github.com/stackagen/docker-hermes-agent-setup/tree/main/coding_space) (Coding Workspace), [`obsidian/brain_dump`](https://github.com/stackagen/docker-hermes-agent-setup/tree/main/obsidian/brain_dump) (Brain Dump Vault)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Deployment Setup"]
  node_env["Environment Settings<br/>[.env]"]
  node_compose["Compose Configuration<br/>[compose.yaml]"]
end

subgraph group_runtime["Hermes Access"]
  node_hermes["Hermes Container<br/>[compose.yaml]"]
  node_dashboard["Dashboard / Gateway<br/>[compose.yaml]"]
  node_api["OpenAI-Compatible API<br/>[compose.yaml]"]
end

subgraph group_workspaces["Agent Workspaces"]
  node_coding["Coding Workspace"]
  node_brain["Brain Dump Vault"]
  node_pokedex["Pokedex Vault"]
  node_coder_soul["Coding Agent Profile<br/>[coder_bro_soul.md]"]
  node_eevie_soul["Filing Agent Profile<br/>[eevie_soul.md]"]
  node_pokedex_soul["Research Agent Profile<br/>[pokedex_soul.md]"]
end

node_user(("Operator"))
node_docker["Docker Desktop"]
node_desktop["Hermes Desktop App"]
node_ollama["Ollama"]
node_obsidian_app["Obsidian"]

node_user -->|"sets paths"| node_env
node_user -->|"sets credentials"| node_compose
node_user -->|"starts Compose"| node_docker
node_compose -->|"references variables"| node_env
node_docker -->|"runs container"| node_hermes
node_compose -->|"defines service"| node_hermes
node_hermes -->|"bind-mounts"| node_coding
node_hermes -->|"bind-mounts"| node_brain
node_hermes -->|"bind-mounts"| node_pokedex
node_user -->|"logs into"| node_dashboard
node_desktop -->|"controls"| node_hermes
node_user -->|"connects to"| node_api
node_ollama -.->|"serves local models"| node_hermes
node_user -->|"loads profile"| node_coder_soul
node_user -->|"loads profile"| node_eevie_soul
node_user -->|"loads profile"| node_pokedex_soul
node_user -->|"views vaults"| node_obsidian_app

click node_env "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/.env"
click node_compose "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml"
click node_hermes "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml"
click node_dashboard "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml"
click node_api "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml"
click node_coding "https://github.com/stackagen/docker-hermes-agent-setup/tree/main/coding_space"
click node_brain "https://github.com/stackagen/docker-hermes-agent-setup/tree/main/obsidian/brain_dump"
click node_pokedex "https://github.com/stackagen/docker-hermes-agent-setup/tree/main/obsidian/pokedex"
click node_coder_soul "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/soul_md_files/coder_bro_soul.md"
click node_eevie_soul "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/soul_md_files/eevie_soul.md"
click node_pokedex_soul "https://github.com/stackagen/docker-hermes-agent-setup/blob/main/soul_md_files/pokedex_soul.md"

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_env,node_compose toneBlue
class node_hermes,node_dashboard,node_api toneAmber
class node_coding,node_brain,node_pokedex,node_coder_soul,node_eevie_soul,node_pokedex_soul toneMint
class node_user,node_docker,node_desktop,node_ollama,node_obsidian_app toneIndigo
```

## Components

### Deployment Setup

- [Environment Settings](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/.env): `.hermes/.env`
- [Compose Configuration](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml): `.hermes/compose.yaml`

### Hermes Access

- [Hermes Container](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml): `.hermes/compose.yaml`
- [Dashboard / Gateway](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml): `.hermes/compose.yaml`
- [OpenAI-Compatible API](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/.hermes/compose.yaml): `.hermes/compose.yaml`

### Agent Workspaces

- [Coding Workspace](https://github.com/stackagen/docker-hermes-agent-setup/tree/main/coding_space): `coding_space`
- [Brain Dump Vault](https://github.com/stackagen/docker-hermes-agent-setup/tree/main/obsidian/brain_dump): `obsidian/brain_dump`
- [Pokedex Vault](https://github.com/stackagen/docker-hermes-agent-setup/tree/main/obsidian/pokedex): `obsidian/pokedex`
- [Coding Agent Profile](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/soul_md_files/coder_bro_soul.md): `soul_md_files/coder_bro_soul.md`
- [Filing Agent Profile](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/soul_md_files/eevie_soul.md): `soul_md_files/eevie_soul.md`
- [Research Agent Profile](https://github.com/stackagen/docker-hermes-agent-setup/blob/main/soul_md_files/pokedex_soul.md): `soul_md_files/pokedex_soul.md`

### Other components

- **Operator**
- **Docker Desktop**
- **Hermes Desktop App**
- **Ollama**
- **Obsidian**

## Connections

- Operator → Environment Settings: sets paths (evidence: `README.md`)
- Operator → Compose Configuration: sets credentials (evidence: `README.md`)
- Operator → Docker Desktop: starts Compose (evidence: `README.md`)
- Compose Configuration → Environment Settings: references variables (evidence: `README.md`)
- Docker Desktop → Hermes Container: runs container (evidence: `README.md`)
- Compose Configuration → Hermes Container: defines service (evidence: `README.md`)
- Hermes Container → Coding Workspace: bind-mounts (evidence: `README.md`)
- Hermes Container → Brain Dump Vault: bind-mounts (evidence: `README.md`)
- Hermes Container → Pokedex Vault: bind-mounts (evidence: `README.md`)
- Operator → Dashboard / Gateway: logs into (evidence: `README.md`)
- Hermes Desktop App → Hermes Container: controls (evidence: `README.md`)
- Operator → OpenAI-Compatible API: connects to (evidence: `README.md`)
- Ollama → Hermes Container: serves local models (evidence: `README.md`)
- Operator → Coding Agent Profile: loads profile (evidence: `README.md`)
- Operator → Filing Agent Profile: loads profile (evidence: `README.md`)
- Operator → Research Agent Profile: loads profile (evidence: `README.md`)
- Operator → Obsidian: views vaults (evidence: `README.md`)
