Let me break this down. Hermes agent image generation just levelled up — you can now generate images with ChatGPT Images 2.0 (GPT-Image-2) directly inside Hermes, and there’s even a free route using Codex auth with no API key.
I set it up on camera, hit the real-world bugs, and found the reliable path. Here’s the full walkthrough.
Last updated: July 2026.
Key takeaways
Hermes can now generate images with ChatGPT Images 2.0 (GPT-Image-2).
Two routes: Codex auth (free, no API key — piggybacks your ChatGPT session) or an OpenAI API key (smoother).
The update comes straight from the Hermes team: you can now use OpenAI auth to generate images with Hermes agent. That means the power of ChatGPT Images 2.0 — genuinely excellent image generation — combined with an agent that can use those images in your workflows. Images are saved locally, so everything stays on your machine.
How to Set It Up (Step by Step)
Update Hermes — run hermes update in your terminal.
Open the tools config — run hermes tools.
Find Image Generation in the list and select it.
Choose Codex auth (free — uses GPT-Image-2 via Codex with no API key) — press spacebar to select.
Restart — exit the session and run a gateway restart.
Test it — ask Hermes to generate an image; it returns the URL and the file.
Full Transparency: The Bugs I Hit
I want to be honest because you’ll likely see the same things. First run, I got “image generation service isn’t configured” errors and some back-and-forth. At one point it quietly switched to a different image generator instead of Codex — I had to tell it explicitly to use the Codex image-gen tool. The fix that worked: I gave Claude the Hermes GitHub details and asked it to repair my local setup, and a fresh session (/new) helped too.
After a couple of minutes of fixing, it worked — genuinely nice images, generated free. But ‘free’ came with friction.
The Smoother Option: An OpenAI API Key
The alternative is plugging in an OpenAI API key for image generation. In my testing this was noticeably smoother and more reliable — image requested, image delivered, saved locally, no arguing with the tool selection.
Codex auth
OpenAI API key
Cost
Free (Codex free tier)
Pay per image
Reliability
A bit buggy
Smooth
API key needed
No
Yes
Best for
Free experimentation
Dependable workflows
What to Use It For
Once image generation is wired in, Hermes can create images as part of bigger workflows — blog thumbnails, social visuals, product mockups — alongside everything else it automates. Pair it with the image studio in an agent OS for a saved gallery of everything you generate (see my local studio guide), or go further with 3D via my Hermes Blender MCP guide.
Which Route Should You Pick?
My honest steer: if you’re experimenting, start with Codex auth — it’s free, and once it’s working it’s genuinely useful; just budget a few minutes for the setup friction and keep Claude on hand to fix the config if needed. If images are part of a workflow you rely on — content pipelines, client work, anything scheduled — use the API key. Paying pennies per image is worth it when a workflow can’t afford to silently fail.
And you can run both: Codex auth as the default, the API key as the fallback for jobs that must ship.
Get the Full Setup
The Agent OS with Hermes image generation, the image studio and all the workflows pre-wired is inside the AI Profit Boardroom — along with full courses on Hermes and agents.
Run hermes update, then hermes tools, configure the Image Generation tool (Codex auth for free, or an OpenAI API key), then restart the gateway and test.
Is Hermes image generation free?
It can be — Codex auth uses GPT-Image-2 via Codex’s free tier with no API key, piggybacking your ChatGPT session. Hermes itself is free too.
Codex auth or API key — which is better?
Codex auth is free but a bit buggy (config errors, occasional wrong tool). The OpenAI API key route is smoother and more reliable if you don’t mind paying per image.
What model does it use?
ChatGPT Images 2.0 — GPT-Image-2 — one of the best image models available.
What if it errors during setup?
You’re not alone — I hit the same. Start a fresh session, explicitly tell it to use the Codex image-gen tool, or hand the GitHub docs to Claude and let it fix your local config.
The Bottom Line
GPT-Image-2 inside Hermes is a genuine upgrade — pick free-but-fiddly or paid-but-smooth. The full setup is in the AI Profit Boardroom.
