🔧 Systeembeheer

📱 Hoe het werkt

De wiki is alleen bereikbaar via Tailscale — het IP-adres 100.108.36.111 is een intern Tailscale-adres en werkt nergens anders. Zonder Tailscale is de wiki onbereikbaar.

Stappen:
1️⃣ Zij installeert de Tailscale app (App Store / Play Store — gratis) en logt in met Google/Apple/email
2️⃣ Jij deelt de VPS via https://login.tailscale.com → Machines → srv1659405 (100.108.36.111) → Share… → haar Tailscale-email erin
3️⃣ Zij opent http://100.108.36.111:8888/index.html in haar browser ✅

Let op: Ze hoeft Tailscale niet actief aan te zetten als VPN. Zolang de app geïnstalleerd is en ze is ingelogd met hetzelfde account waarmee jij gedeeld hebt, routeert Tailscale op de achtergrond het 100.x.x.x-verkeer — geen extra knop nodig.

Ingericht: 12 juli 2026 · Via login.tailscale.com (mobiel of desktop) · Werkt op iPhone en Android

⚠️ Enige puntje: propagatievertraging

Na het delen kan het 30-60 seconden duren voor de VPS op haar apparaat verschijnt. Ze ziet in de Tailscale-app pas "Connected" als het werkt. Gewoon even geduld — na een minuut de website opnieuw laden en het werkt.

🔊 TTS — Text-to-Speech

Actieve provider: edge (edge-tts) — lokaal, gratis, geen API-key
Stem: en-US-AriaNeural

Andere geconfigureerde providers (switchable via config):
• ElevenLabs — voice_id: pNInz6obpgDQGcFmaJgB, model: eleven_multilingual_v2
• OpenAI — model: gpt-4o-mini-tts, voice: alloy
• Gemini — model: gemini-2.5-flash-preview-tts, voice: Kore
• xAI — voice_id: eve, language: en, sample_rate: 24000
• Mistral — model: voxtral-mini-tts-2603
• Neuphonic — model: neuphonic/neutts-air-q4-gguf, device: cpu (lokaal)
• Piper — voice: en_US-lessac-medium (lokaal, nodeloos minimal)

Gebruik: Hermes kan via de text_to_speech tool spraakberichten sturen in Telegram (audio-bestand).
Let op: auto_tts: false — Hermes leest niet automatisch voor, alleen op commando of via de tool.

🎙️ STT — Speech-to-Text (spraakherkenning)

Status: Ingeschakeld ✅
Provider: local — faster-whisper (lokaal, gratis, geen internet nodig)
Model: base (balans tussen snelheid en nauwkeurigheid)
Opnametoets: Ctrl+B
Max opnameduur: 120 seconden
Stilte-detectie: 200ms drempel, 3 seconden stilte = automatisch stoppen
Signaaltoon: Ja (beep bij start/stop)

Gebruik: Houd Ctrl+B ingedrukt in de CLI, spreek in, laat los — Hermes verwerkt het via local faster-whisper.
Telegram: Spraakberichten worden automatisch getranscribeerd via dezelfde STT-pipeline.

1 juli 2026 — Maandelijkse optimalisatiecheck #2 (DeepSeek V4 Flash)

Periode: 1 juni — 1 juli 2026 (30 actieve dagen)
Sessies: 228 · Berichten: 7.463 · Toolcalls: 2.766
Totale tokens: 346,6M · Actieve tijd: ~23,5 dagen
Gem. sessie: 32,7 berichten · ~2u42m

📊 Modelgebruik:
• deepseek-v4-flash: 137 sessies (60%) — 159,2M tokens — dominant model ✅
• deepseek-chat: 62 sessies — 67,3M tokens (cron/fallback verkeer)
• deepseek-v4-pro: 11 sessies — 66,2M tokens (zware ad-hoc taken)
• claude-sonnet-4-6: 4 sessies — 47,8M tokens (complexe Telegram sessies)
• claude-sonnet-4.6: 1 sessie — 6,1M tokens
• unknown: 13 sessies

📱 Platformverdeling:
• cron: 137 sessies, 946 msgs, 3,1M tokens (monitoring/cronjobs — laag verbruik per sessie)
• telegram: 91 sessies, 6.517 msgs, 343,6M tokens (99% van het tokenverbruik)
• CLI: 0 sessies (geen CLI gebruik deze periode)

🧰 Top tools:
• terminal: 1.429 (51,7%)
• read_file: 300 (10,8%)
• patch: 226 (8,2%)
• search_files: 150 (5,4%)
• cronjob: 121 (4,4%)
• browser_navigate: 111 (4,0%)
• session_search: 69 (2,5%)
• skill_view: 60 (2,2%)
• 13 andere tools met < 50 calls

🧠 Skills (12 gebruikt van 29 actief):
• hermes-agent (20 loads), wiki-update (9), juridische-kennisbank (2 loads, 7 edits),
• hermes-providers (6), ib-gateway-docker (5), claude-code (5),
• home-assistant (4), trading-strategy-backtesting (4),
• hermes-docker-operations (2), hermes-wiki (2)
• 17 skills niet geladen in 30 dagen — 11 hiervan inmiddels gearchiveerd.

💾 Memory: Niet direct bereikbaar vanuit cron-context (draait in Docker).
Vorige check (1 juni): 3.936/4.000 chars (98%) — bijna vol. Limiet inmiddels verhoogd naar 8.000 chars (12 juni).

💾 Skills op disk: 30 SKILL.md bestanden (actief) na opschoning. Geen .hermes/ storage files op deze host.

🔧 Aanbevelingen (uitgevoerd):
• 11 ongebruikte skills gearchiveerd: daisycon, wordpress, google-search-console, vps-security-audit, visual-diagrams, youtube-content, lead-email-automation, kanban-*, ocr-and-documents, himalaya
• Resterend: 30 actieve skills (18 ongebruikt maar niet storend)
• Memory check binnen container: docker exec hermes-agent date + memory inspectie aanbevolen
• Trends stabiel: Flash dominant (60% sessies), terminal blijft #1 tool (52%), Telegram = bulk verkeer
• Kosten blijven laag — Flash-cache reads drukken effectieve kosten
• Geen CLI gebruik deze periode — normaal patroon
• 25-daagse activiteitsstreak — Hermes is consistent actief ✅

Reden: Maandelijkse optimalisatiecheck — alles stabiel, 29 skills ongebruikt, memory niet controleerbaar vanuit cron.

23 juni 2026 — Claude Sonnet 4.6 eindelijk werkend via directe Anthropic API

Probleem (langlopend):
/model claude-sonnet-4-6 gaf consequent "Provider authentication failed" — ook als de API key via curl gewoon 200 teruggaf. Alle 4 lagen leken correct (key, env var, config, credential pool), maar de native anthropic provider bleef 401 geven.

Root cause — twee problemen gecombineerd:
1. Anthropic SDK v0.87.0 bug — de Python SDK weigerde de key met 401 terwijl curl dezelfde key accepteerde. SDK-versieprobleem, niet een key-probleem.
2. .env key ≠ config.yaml key — de gateway leest de key uit /opt/data/.env, niet uit config.yaml. De .env bevatte een verlopen key (...kgAA) terwijl config.yaml de correcte key had (...VgAA).

Oplossing — in volgorde uitgevoerd:
1. SDK upgrade (als root op VPS-host):
docker exec hermes-agent uv pip install --upgrade anthropic --python /opt/hermes/.venv/bin/python3
2. .env gesynct met config.yaml key (Python heredoc in container, omzeilt Hermes key-masking)
3. docker restart hermes-agent — na restart laadt Hermes de nieuwe SDK (0.111.0)
4. /model claude-sonnet-4-6 ✅ — werkt nu via directe Anthropic API

Bijkomende setup — copilot-acp als backup:
Tijdens het debugproces ook de copilot-acp provider ingericht als alternatieve route via Claude Pro subscription ($20/mnd). Blijft als backup staan. Wrapper: /opt/data/home/bin/claude-acp-run.sh. ACP package: @agentclientprotocol/claude-agent-acp.

Voortaan: bij een 401 op de Anthropic provider altijd eerst checken:
• SDK versie: /opt/hermes/.venv/bin/python3 -c "import anthropic; print(anthropic.__version__)" — moet ≥ 0.111.0 zijn
• .env vs config.yaml key suffix: beide moeten overeenkomen
• Na SDK upgrade of .env wijziging: docker restart hermes-agent verplicht

Duur: meerdere sessies over meerdere dagen. Uiteindelijk opgelost via SDK upgrade + .env sync + restart.

12 juni 2026 — Providerwissel: OpenRouter vervangen door directe DeepSeek API + Anthropic

Wijzigingen:
• OpenRouter volledig verwijderd als provider
• Hoofdmodel: deepseek-v4-flash via directe DeepSeek API (custom provider, https://api.deepseek.com/v1)
• Tweede provider toegevoegd: Anthropic (claude-sonnet-4-20250514) voor fallback/CLI-sessies
• API-keys: DeepSeek in config.yaml, Anthropic in .env
• Kostenbesparing: geen OpenRouter markup (~10-15%) — Flash van $0.10 → $0.07 input
• Memory limiet verhoogd: 4.000 → 8.000 chars
• User profile limiet verhoogd: 2.000 → 4.000 chars
• Model switch commando's: /model deepseek-v4-pro (Pro), /model claude-sonnet-4-20250514 (Claude Sonnet 4)

✅ Inmiddels opgelost: Delegatie overgezet naar directe DeepSeek API op 12 juni.

⚠️ Nog niet overgezet (loopt nog via OpenRouter):
• Vision model (config: auxiliary.vision.provider = openrouter)

Reden: Geen OpenRouter meer nodig — directe DeepSeek API is sneller, goedkoper en betrouwbaarder. Anthropic als fallback voor complexe taken.

1 juni 2026 — Maandelijkse optimalisatiecheck #1 (DeepSeek V4 Flash)

Periode: 19 mei – 1 juni 2026 (13 actieve dagen)
Sessies: 274 · Berichten: 6.370 · Toolcalls: 2.303
Totale tokens: 350,8M · Geschatte kosten: ~$5-10/maand

📊 Modelgebruik:
• deepseek-v4-flash: 238 sessies (84%) — dominant model ✅
• deepseek-v4-pro: 16 sessies (cron/fallback)
• deepseek-chat: 3 sessies (fallback)
• claude-opus-4.6: 15 sessies (telegram, complexe taken)
• claude-sonnet-4: 1 sessie

📱 Platformverdeling:
• cron: 238 sessies, 1.582 msgs, 6,5M tokens (monitoring/cronjobs — laag verbruik per sessie)
• telegram: 36 sessies, 4.788 msgs, 344,3M tokens (bulk van het werk) — geen CLI-sessies

🧰 Top tools: terminal (56%), read_file (9,3%), patch (9,3%), search_files (4,9%), memory (3,5%)

🧠 Skills: 42 SKILL.md bestanden actief. 15 gebruikt in 30 dagen.
Meest gebruikte: hermes-wiki (29x), wordpress-setup (45x)
Ongebruikt (0 keer geladen): daisycon-site-verificatie, vision-setup-and-analysis (allebei nieuw, < 30 dagen oud)

💾 Memory: 3.936/4.000 chars (98%) — bijna vol. USER.md: 1.910/2.000 chars (96%).
⚠️ Memory nadert capaciteit — overweeg comprimeren of limiet verhogen naar 5.000 chars.

🔧 Aanbevelingen:
• Memory vol: zet memory_char_limit op 5.000 of comprimeer oude entries → hermes config set memory.memory_char_limit 5000
• Sessions groeien: 507 sessiebestanden (136MB), overweeg hermes sessions prune --older-than 90
• Geen CLI-sessies in deze periode — alles via Telegram of cron. Dit is normaal.
• Kosten blijven laag (~$5-10/maand) dankzij 84% Flash-gebruik ✅
• 27 skills niet geladen in 30 dagen — dit zijn grotendeels eenmalige setup-skills (daisycon, github-auth, etc.). Geen actie nodig.

Reden: Maandelijkse optimalisatiecheck — alles stabiel, memory nadert limiet.

14 juni 2026 — Wekelijks API-kostenoverzicht (7-14 juni)

Periode: 7 juni — 14 juni 2026
Sessies: 80 · Berichten: 2.621 · Tool calls: 788
Totale tokens: 101,5M · Actieve tijd: ~7 dagen

📊 Tokenverbruik per model:
• deepseek-v4-flash (alle varianten): 67 sessies — Input: 10,6M · Output: 370K · Cache read: 59,2M · Cache write: 4,4M
• deepseek-v4-pro: 2 sessies — Input: 535K · Output: 90K · Cache read: 20,9M

📱 Platformverdeling:
• Telegram: 39 sessies, 2.417 msgs, ~100,1M tokens (99% van verbruik)
• Cron: 41 sessies, 204 msgs, ~509K tokens (monitoring)

🧰 Top tools: terminal (54,8%), read_file (10,4%), patch (8,8%), search_files (7,1%), cronjob (5,5%)

🧠 Skills: 5 skills geladen, 10 edits — juridische-kennisbank meest bewerkt (7x), daarna claude-code en wiki-update (5x/4x loads)

💰 Geschatte kosten: ~101,5M tokens waarvan ~68M Flash-cache reads = vrijwel gratis. Effectief: ~1,5M Output tokens × $0,20/M ≈ $0,30/week, of ~$1,20/maand

✅ Conclusie: Verbruik stabiel en laag. Geen bijzondere afwijkingen.

Reden: Maandelijkse optimalisatiecheck — alles stabiel, memory nadert limiet.

14 juni 2026 — Wekelijks API-kostenoverzicht (7-14 juni)

Periode: 7 juni — 14 juni 2026
Sessies: 80 · Berichten: 2.621 · Tool calls: 788
Totale tokens: 101,5M · Actieve tijd: ~7 dagen

📊 Tokenverbruik per model:
• deepseek-v4-flash (alle varianten): 67 sessies — Input: 10,6M · Output: 370K · Cache read: 59,2M · Cache write: 4,4M
• deepseek-v4-pro: 2 sessies — Input: 535K · Output: 90K · Cache read: 20,9M

📱 Platformverdeling:
• Telegram: 39 sessies, 2.417 msgs, ~100,1M tokens (99% van verbruik)
• Cron: 41 sessies, 204 msgs, ~509K tokens (monitoring)

🧰 Top tools: terminal (54,8%), read_file (10,4%), patch (8,8%), search_files (7,1%), cronjob (5,5%)

🧠 Skills: 5 skills geladen, 10 edits — juridische-kennisbank meest bewerkt (7x), daarna claude-code en wiki-update (5x/4x loads)

💰 Geschatte kosten: ~101,5M tokens waarvan ~68M Flash-cache reads = vrijwel gratis. Effectief: ~1,5M Output tokens × $0,20/M ≈ $0,30/week, of ~$1,20/maand

✅ Conclusie: Verbruik stabiel en laag. Geen bijzondere afwijkingen.

Bron: Wekelijkse API-kostenoverzicht cron job — nu automatisch elke zondag 10:00 UTC.

28 mei 2026 — Fallback provider + Backup naar Windows

• Fallback provider ingesteld: DeepSeek Pro (deepseek/deepseek-chat) via OpenRouter
• Backup script uitgebreid: kopieert nu ook naar Hermes Inbox (SMB → Windows desktop)
• Eerste off-site backup (17 MB) succesvol naar Windows gesynchroniseerd
• Wiki server permanent gemaakt: watchdog cron elke 5 min, poort 8888
• Wiki regeneratie: dagelijks 04:00 UTC naar /opt/data/documents/wiki/
• Wiki server script: /opt/data/scripts/wiki-server.sh

Reden: lege responses van V4 Flash opvangen (fallback) en off-site backup regelen.

26 mei 2026 — Bootstrapping optimalisatie

• Personalities teruggebracht van 12 → 3 (gimmicks verwijderd)
• Skills gereduceerd van 92 → 31 actief (61 gearchiveerd)
• Memory limiet verhoogd: 2.200 → 4.000 chars
• User profile limiet verhoogd: 1.375 → 2.000 chars
• Vision ingesteld: Google Gemini 2.0 Flash voor screenshots
• show_cost: true ingesteld
• Maandelijkse optimalisatie-cron gestart (elke 1e van de maand, 05:00 UTC)

Reden: token overhead verlagen en rekening drukken na overstap naar DeepSeek Flash.

25 mei 2026 — Modeloverstap

• Standaard model: deepseek-v4-pro → deepseek-v4-flash
• Delegatie model: ingesteld op deepseek-v4-flash
• Kostenbesparing: ~75% per token