feat(image_gen): add openai-codex plugin (gpt-image-2 via Codex OAuth) by teknium1 · Pull Request #14317 · NousResearch/hermes-agent

teknium1 · 2026-04-23T03:14:19Z

Summary

New built-in openai-codex image-gen backend — gpt-image-2 routed through ChatGPT/Codex OAuth, no OPENAI_API_KEY required. Sits alongside the existing openai API-key plugin as a separate selectable provider.

Changes

plugins/image_gen/openai-codex/: new plugin (provider name openai-codex, same gpt-image-2 low/medium/high catalog as the API-key plugin)
Uses Codex Responses image_generation tool via client.responses.stream(...); final image saved to $HERMES_HOME/cache/images/ with prefix openai_codex_
Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client (token expiry, cred-pool, Cloudflare originator all centralized there)
Tests in tests/plugins/image_gen/test_openai_codex_provider.py — metadata, availability gating, stream request shape, partial-image fallback, final-response sweep, error paths, registration

Validation

scripts/run_tests.sh tests/plugins/image_gen/ -q → 42 passed (16 existing openai + 26 new openai-codex).

E2E discovery check: both providers list separately in agent.image_gen_registry.list_providers():

- name='openai'        display='OpenAI'              available=False
- name='openai-codex'  display='OpenAI (Codex auth)' available=False

Each becomes available independently (OPENAI_API_KEY for one, Codex OAuth for the other), and the user picks via hermes tools or image_gen.provider in config.yaml.

Notes

Inspired by fix(image_gen/openai): support Codex auth fallback in OpenAI provider #14047 by @Hygaard. Re-implemented as a standalone plugin rather than an in-place fork of the openai plugin so the two backends stay independently selectable instead of one silently shadowing the other based on which auth happens to be present.

Closes #11195

@Hygaard

New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by #14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes #11195

sanchomuzax · 2026-04-23T04:52:55Z

Its not working...

Screenshot_2026-04-23-06-51-50-024_com termux

Screenshot_2026-04-23-06-51-59-080_org telegram messenger-edit

Its required:

~/.hermes/hermes-agent/venv/bin/python -m hermes_cli.main config set image_gen.provider openai-codex
~/.hermes/hermes-agent/venv/bin/python -m hermes_cli.main gateway restart

helix4u · 2026-04-23T05:22:13Z

boop #14380 should fix the guy above me's problem... i had it too.

dannyshmueli · 2026-04-23T06:52:25Z

Hermes told me:
- No OpenAI image key is available in this Hermes session
- No FAL key is available either
- Hermes’s image tool is currently unconfigured here, so I can’t actually generate the image yet

- env has no OPENAI_ or FAL_ image creds
- ~/.hermes/.env also doesn’t contain an OpenAI image key

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

@Hygaard

NousResearch#14317) New built-in image_gen backend at plugins/image_gen/openai-codex/ that exposes the same gpt-image-2 low/medium/high tier catalog as the existing 'openai' plugin, but routes generation through the ChatGPT/ Codex Responses image_generation tool path. Available whenever the user has Codex OAuth signed in; no OPENAI_API_KEY required. The two plugins are independent — users select between them via 'hermes tools' → Image Generation, and image_gen.provider in config.yaml. The existing 'openai' (API-key) plugin is unchanged. Reuses _read_codex_access_token() and _codex_cloudflare_headers() from agent.auxiliary_client so token expiry / cred-pool / Cloudflare originator handling stays in one place. Inspired by NousResearch#14047 by @Hygaard, but re-implemented as a separate plugin instead of an in-place fork of the openai plugin. Closes NousResearch#11195

alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have comp/plugins Plugin system and bundled plugins tool/vision Vision analysis and image generation provider/openai OpenAI / Codex Responses API labels Apr 23, 2026

teknium1 merged commit eda5ae5 into main Apr 23, 2026
11 of 12 checks passed

teknium1 deleted the hermes/hermes-bad35a6c branch April 23, 2026 03:43

teknium1 mentioned this pull request Apr 23, 2026

fix(image_gen/openai): support Codex auth fallback in OpenAI provider #14047

Closed

This was referenced Apr 23, 2026

fix(image-gen): force-refresh plugin providers in long-lived sessions #14502

Merged

feat(image-gen): add Codex-backed image generation provider #14281

Closed

barronlroth mentioned this pull request Apr 23, 2026

[Feature]: support gpt-image-2 in image_generate via Codex OAuth openclaw/openclaw#70703

Closed

lumenradley mentioned this pull request Apr 23, 2026

feat(image_gen): add per-call Codex output controls #14819

Closed

19 tasks

github-actions Bot mentioned this pull request Apr 24, 2026

chore: bump NousResearch/hermes-agent version from v2026.4.16 to v2026.4.23 Docker-Hub-sirmark/docker-hermes-agent#3

Merged

onecvengineer mentioned this pull request Apr 24, 2026

openai-codex gpt-image-2 drifts on Chinese named-character prompts vs ChatGPT UI #15138

Open

dejay2 mentioned this pull request Apr 24, 2026

feat(image_gen): multi-reference input support, starting with openai-codex #15308

Closed

4 tasks

teknium1 mentioned this pull request Apr 27, 2026

fix: add codex fallback for image generation #14016

Closed

jarvis-iburi mentioned this pull request May 13, 2026

[Feature]: Surface the bundled openai-codex image_gen plugin in the hermes tools picker so Codex subscribers don't need FAL_KEY #24965

Closed

snese mentioned this pull request May 22, 2026

Add Bedrock image generation provider (Stability AI) #30427

Closed

1 task

mydearzsy mentioned this pull request Jun 11, 2026

Feature: Support at least one Chinese image generation provider (e.g., DashScope, Volcano, or MiniMax) #44167

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(image_gen): add openai-codex plugin (gpt-image-2 via Codex OAuth)#14317

feat(image_gen): add openai-codex plugin (gpt-image-2 via Codex OAuth)#14317
teknium1 merged 1 commit into
mainfrom
hermes/hermes-bad35a6c

teknium1 commented Apr 23, 2026

Uh oh!

Uh oh!

sanchomuzax commented Apr 23, 2026 •

edited

Loading

Uh oh!

helix4u commented Apr 23, 2026 •

edited

Loading

Uh oh!

dannyshmueli commented Apr 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

teknium1 commented Apr 23, 2026

Summary

Changes

Validation

Notes

Uh oh!

Uh oh!

sanchomuzax commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

helix4u commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dannyshmueli commented Apr 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

sanchomuzax commented Apr 23, 2026 •

edited

Loading

helix4u commented Apr 23, 2026 •

edited

Loading