hermes - 💡(How to fix) Fix image_gen and vision tools not working after fresh install

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

Suggested fix: Have hermes config set auxiliary.vision.api_key automatically sync to .env, or raise an error when .env key is not found.

Root Cause

Root cause: config.yaml's toolsets list doesn't include "image_gen" — only ["hermes-cli"]. Without the toolset enabled, the tool is never registered to the LLM, no matter how complete the plugin is.

Fix Action

Fix / Workaround

Workaround: Manually write key to .env: OPENROUTER_API_KEY=sk-or-v1-...

RAW_BUFFERClick to expand / collapse

Problem Description

After installing Hermes Agent, image_gen (image generation) and vision (image recognition) don't work out of the box — users have to debug deep into the code to get them running.

Issue 1: image_gen toolset not enabled

Symptom: MiniMax image generation plugin exists at plugins/image_gen/minimax/, config.yaml has image_gen.provider: minimax configured, but image_generate tool never works.

Root cause: config.yaml's toolsets list doesn't include "image_gen" — only ["hermes-cli"]. Without the toolset enabled, the tool is never registered to the LLM, no matter how complete the plugin is.

Reproduction: hermes config get toolsets # returns ["hermes-cli"]

Fix: Users must manually run: hermes config set toolsets '["hermes-cli", "image_gen"]'

Issue 2: auxiliary.vision.api_key written to wrong location

Symptom: hermes config set auxiliary.vision.api_key <KEY> succeeds, but vision_analyze still fails with "Auxiliary: marking openrouter unhealthy for 60s", then falls back to a non-vision model.

Root cause: auxiliary_client.py's _try_openrouter() only reads os.getenv("OPENROUTER_API_KEY") (from .env file), NOT config.yaml's auxiliary.vision.api_key. So even when users "correctly" configure vision.api_key, it is never used — instead an empty key triggers an unhealthy mark.

Workaround: Manually write key to .env: OPENROUTER_API_KEY=sk-or-v1-...

Suggested fix: Have hermes config set auxiliary.vision.api_key automatically sync to .env, or raise an error when .env key is not found.

###Issue 3: vision toolset also easy to miss

Symptom: vision tool depends on vision toolset — without it in toolsets, the tool is completely invisible.

Suggestion: Default toolsets should include ["hermes-cli", "image_gen", "vision"], or the installer should auto-detect installed plugins.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING