hermes-config-guard
Fix Hermes /model picker clutter, duplicate providers, and excluded-provider leaks. Use when Telegram /model shows too many providers, duplicates, stepfun/google/gemini ghosts, or excluded providers still visible.
- License 许可
- MIT
- 最近更新
- 2026-09-18
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- hermes-config-guard
- metadata
- { "author": "sillyhippy.zo.computer" }
- description
- Fix Hermes /model picker clutter, duplicate providers, and excluded-provider leaks. Use when Telegram /model shows too many providers, duplicates, stepfun/google/gemini ghosts, or excluded providers still visible.
- compatibility
- Created for Zo Computer
02 资源文件 5
- 脚本scripts/audit_picker.py2.7 KB
- 脚本scripts/backup.sh740 B
- 脚本scripts/fix_picker.py3.5 KB
- 脚本scripts/fix.sh1.8 KB
- 脚本scripts/validate.sh2.1 KB
03 SKILL.md 正文
Hermes Config Guard
Fixes recurring Hermes /model picker problems on Telegram and other gateways.
One Command
# Audit first (read-only)
python3 /home/workspace/Skills/hermes-config-guard/scripts/audit_picker.py
# Fix + gateway restart
python3 /home/workspace/Skills/hermes-config-guard/scripts/fix_picker.py
Legacy shell wrappers still work:
bash /home/workspace/Skills/hermes-config-guard/scripts/backup.sh
bash /home/workspace/Skills/hermes-config-guard/scripts/validate.sh
bash /home/workspace/Skills/hermes-config-guard/scripts/fix.sh
Root Cause (read this)
Hermes has two hide mechanisms — agents confuse them constantly:
| Mechanism | Config path | What it hides |
|---|---|---|
| Picker exclusion | model_catalog.excluded_providers |
Built-in / auth-discovered providers only |
| User provider off | providers.<name>.enabled: false |
Your manual providers: blocks |
Critical: If a provider exists under providers: in config.yaml, excluded_providers does not hide it. You must set enabled: false on that block.
Example — these are in excluded_providers but still show until disabled:
groq,mistral,deepseek,gemini,kilocode,opencode-gocerebras,modelscope,longcat,sakana,openai-api
fix_picker.py auto-applies enabled: false to any user provider whose slug is in excluded_providers.
Validation Checklist
Config (/root/.hermes/config.yaml)
- [ ] No duplicate keys under
providers: - [ ]
model_catalog.excluded_providerslists providers you never want in the picker - [ ] Every excluded user provider has
enabled: false - [ ]
disable_auto_providershas lowercase and Title Case pairs (legacy auto-discovery guard) - [ ] Default model/provider matches intent (
free/oc/mimo-v2.5-freefor free tier)
Auth (/root/.hermes/auth.json)
- [ ] No
stepfunpool (causes ghost provider) - [ ] No
custom:gemini,custom:gemini-1,custom:mistral,custom:clod
Picker code hygiene (model_switch.py)
Joe-local post-filter drops: stepfun, google, custom:gemini*, opencode-zen*
Aliases: google → gemini, opencode-zen-go-custom → opencode-go
After any config change
Gateway must restart — running gateway reads stale config:
bash /home/workspace/Skills/hermes-gateway/scripts/hermes-gateway.sh restart
# or: supervisorctl restart hermes-gateway
Expected Picker (~20 providers)
After fix, visible providers should be roughly:
- Mixture of Agents, free, 9router, kiro, gumloop, replit, command-code, cursor-sdk
- grok-9router, antigravity, nvidia-nim, mistral-9router, free-router, free-clod
Hidden (via exclusion + enabled:false): native groq/mistral/deepseek/gemini/kilocode/opencode-go, openrouter, copilot, nous, nvidia NIM auth row, etc.
File Locations
| File | Path |
|---|---|
| Main config | /root/.hermes/config.yaml |
| Auth store | /root/.hermes/auth.json |
| Picker logic | /usr/local/lib/hermes-agent/hermes_cli/model_switch.py |
| Backups | /home/workspace/Backups/hermes/ |
When to Use
/modelshows 30+ providers / 4 pages on Telegram- Provider in
excluded_providersstill visible - stepfun, google, or duplicate gemini rows appear
- After editing providers or auth credentials
04 同仓库更多 Skills
zopack
Export and import zo.space route setups as shareable .zopack.md files. Use when the user wants to package their zo.space routes for sharing, or when they receive a .zopack.md file to deploy. Triggers on "export my zo.space", "create a zopack", "import this zopack", or any mention of .zopack.md files.
zoho-mail-inbox
Full inbox management for Zoho Mail (info@justlegalsolutions.org) — list unread, mark all as read, delete by sender/keyword, search, send from aliases, list folders. Fully self-contained — zero setup needed.
weekly-meeting-reminder
Get an email every Sunday evening listing your meetings for the coming week.
Let Zo use your X (Twitter) account
zo-tools
Internal process tools for Zo and Hermes — local search, document processing, OCR, and embeddings. All services run on localhost, zero HTTP slots consumed.
ssh-setup
Sets up secure remote access to your Zo Computer so you can connect from anywhere