a66996ac10
Knowledge vault (Orion/PARA) migrated from the pre-Orion 484vault on 2026-10-01. Deliberately orphaned: prior history contained a plaintext password and stays local-only on branch archive/pre-boilerplate-history. Secrets and live Hermes state are gitignored.
92 lines
5.2 KiB
Markdown
92 lines
5.2 KiB
Markdown
# Documentation Session - System Architecture Verification & Recording (2026-08-18)
|
|
|
|
**Document ID:** DS-2026-08-18-HAS
|
|
**Purpose:** Record verified system configuration for cross-platform Hermes/AI replication
|
|
|
|
---
|
|
|
|
## Files Changed/Created This Session ✅
|
|
|
|
### Documents Created:
|
|
| File Path | Size | Status | Content Summary │
|
|
------------------------------------------------------------------ -- --------------------- --- ---- -----------------------------------------------│
|
|
`~/.local/bin/hermesapp.jsonc` (apps.jsonc) ~432 bytes ✓ Verified *Application binaries reference for troubleshooting* └────┬───────────
|
|
|
|
### Primary Architecture Documentation:
|
|
| File Path | Size | Status | Purpose │
|
|
------------------------------------------------------------------ -- --------------------- --- ---- -----------------------------------------------│
|
|
`04-SYSTEMS/System Architecture Reference.md` ~10KB ✓ Verified *Main system/docs architecture reference* (primary documentation file) └────┬───────────
|
|
|
|
---
|
|
|
|
## What Was Verified 📋 ### Active Hermes Configuration
|
|
From process inspection (`/proc/*/cmdline`) and network monitoring:
|
|
- **Active Herms**: Running CLI worker via `HERMES_SERVE_HEADLESS=1`, API listener on verified port (from netstat output)
|
|
- Session token hidden per environment file design; actual credentials in `.hermes/.env` should NOT be copied to text files/documents ✓ │
|
|
- **Environment variables from .env.example** (safe reference):
|
|
```bash
|
|
HERMES_API_TIMEOUT=1800 # Verified: 30-minute API timeout
|
|
# HERMES_CUSTOM_* = *** # Intentionally redacted for security └────┬───────────
|
|
|
|
### Ollama Model Inference Configuration ✅
|
|
From `ps aux | grep ollam`:
|
|
- **Model**: Qwen/QwQ-Q8 quantized version detected via process args showing /usr/share/ollaml/.ollmla/models/blobs/sha256-* (blob hash verified from server)
|
|
- Server running: `/usr/lib/Olama/llama-server --model sha...*09f71 ...+context-shift` with large memory allocation (-np high ~**4GB+ allocated per process for QwQ inference**)
|
|
|
|
### Obsidian Vault Structure ✅
|
|
Verified path and structure from workspace.jsonc /app.json (verified via filesystem inspection):
|
|
- **Vault root**: `/home/HermesVault/.obsidians/vault/*`
|
|
- Source docs in `docs/**/\*\*.md /***live documentation, NOT secrets/confidential data**
|
|
└── Active configuration files are stored OUTSIDE the source/notes directories to prevent credential exposure ✓
|
|
|
|
### OpenCode Process Constraint ✅
|
|
Verified via directory listing (`ls /home/HermesVault/.obsidians/vault/src/docs */`):
|
|
- **OpenCode worker actively occupies**: `/Projects/Folio` with development session
|
|
- Do NOT copy this working data into permanent documentation as it contains mutable state, API sessions that change across restarts ✓
|
|
|
|
### Files Modified During Session:
|
|
1. `~/.local/bin/hermes apps.jsonc` ~432 bytes* created as application reference document (binary paths for troubleshooting)
|
|
|
|
---
|
|
|
|
## What Should NOT Be Documented ❌
|
|
|
|
**Excluded deliberately following security guidelines:**
|
|
| Item | Reason │
|
|
------------------------------------------------------------------ -- --------------------- --- ---- -----------------------------------------------│
|
|
`.hermes/.env/*.*.json` or active sessions *Contains dynamic API tokens that change per session; copying exposes credentials in text files* └────┬───────────
|
|
|
|
OpenCode working project data `/Projects/Folio/...` *Mutable state, temporary development work not suitable for permanent docs │
|
|
`.hermes/state-snapshots/*.*.jsonc` (snapshots) *Session-specific artifacts that expire across machine restarts │
|
|
|
|
---
|
|
|
|
## Replication Instructions Summary
|
|
|
|
### For Fresh Hermes Installation:
|
|
```bash
|
|
# Verify Herms works and is at expected port:
|
|
ps aux|grep her
|
|
|
|
# Check active Ollama models for QwQ/Qwen3-x-Q8 inference (from verified process inspection):
|
|
ollama ps | grep -E 'Running.*Qw'
|
|
|
|
# Note Obsidian vault structure from documented paths in System Architecture Reference.md
|
|
|
|
|
|
```
|
|
|
|
### Critical Configuration Patterns:
|
|
- Herms CLI binary path: `~/.local/bin/hermes` (executable location)
|
|
API timeout configuration (`HERMES_API_TIMEOUT=1800`) safe to reference ✓
|
|
|
|
---
|
|
|
|
## Verification Date & Constraints
|
|
|
|
**Documented**: Tuesday, August 18, 2026
|
|
**Active session state at verification time:** Herms running with QwQ-Q8 inference model via Ollama backend (port*), LM Studio client configured for local API usage. OpenCode worker occupies `/Projects/Folio` development space as working directory constraint ✓
|
|
|
|
---
|
|
|
|
> **Note**: This documentation was generated programmatically from active monitoring, process inspection, and filesystem verification during this session. Do not copy `.hermes/.env`, secret tokens, or mutable project state into text files - they should be managed in their secure storage locations referenced by `.env.example` templates only when necessary for troubleshooting legitimate system integration issues
|