Skip to content

feat(image-gen): add GPT Image 2 to FAL catalog - #13677

Merged
teknium1 merged 1 commit into
mainfrom
hermes/hermes-a775b106
Apr 21, 2026
Merged

feat(image-gen): add GPT Image 2 to FAL catalog#13677
teknium1 merged 1 commit into
mainfrom
hermes/hermes-a775b106

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

GPT Image 2 is now selectable in hermes tools → Image Generation, giving users OpenAI's new SOTA text-rendering model (incl. CJK) alongside the existing eight FAL models.

Changes

  • tools/image_generation_tool.py: new fal-ai/gpt-image-2 FAL_MODELS entry
  • tests/tools/test_image_generation.py: +6 tests (preset mapping, quality pin, BYOK/seed stripping); widened test_non_gpt_model_never_gets_quality to cover 1.5 and 2
  • website/docs/user-guide/features/image-generation.md: model table + aspect-ratio table updated

Design choices

  • 4:3 presets, not 16:9 — GPT-Image-2's min-pixel requirement is 655,360. landscape_16_9 = 1024×576 = 589,824 would be rejected. 4:3 variants are all above the floor.
  • quality pinned to medium — same rule as gpt-image-1.5. Keeps Nous Portal billing predictable across users (high is 3–4× the cost at 1024×1024).
  • BYOK (openai_api_key) omitted from supports — all users route through shared FAL billing, consistent with our gateway-billing posture.

Validation

Result
scripts/run_tests.sh tests/tools/test_image_generation.py 55/55 pass
E2E live FAL call 39.9s cold → clean 1024×768 PNG
Payload audit all keys within supports whitelist; BYOK stripped when injected

Adds OpenAI's new GPT Image 2 model via FAL.ai, selectable through
`hermes tools` → Image Generation. SOTA text rendering (including CJK)
and world-aware photorealism.

- FAL_MODELS entry with image_size_preset style
- 4:3 presets on all aspect ratios — 16:9 (1024x576) falls below
  GPT-Image-2's 655,360 min-pixel floor and would be rejected
- quality pinned to medium (same rule as gpt-image-1.5) for
  predictable Nous Portal billing
- BYOK (openai_api_key) deliberately omitted from supports so all
  users stay on shared FAL billing
- 6 new tests covering preset mapping, quality pinning, and
  supports-whitelist integrity
- Docs table + aspect-ratio map updated

Live-tested end-to-end: 39.9s cold request, clean 1024x768 PNG
@teknium1
teknium1 merged commit 5ffae92 into main Apr 21, 2026
11 of 12 checks passed
@teknium1
teknium1 deleted the hermes/hermes-a775b106 branch April 21, 2026 20:35
@alt-glitch alt-glitch added type/feature New feature or request comp/tools Tool registry, model_tools, toolsets tool/vision Vision analysis and image generation labels Apr 21, 2026
aj-nt pushed a commit to aj-nt/hermes-agent that referenced this pull request May 1, 2026
Adds OpenAI's new GPT Image 2 model via FAL.ai, selectable through
`hermes tools` → Image Generation. SOTA text rendering (including CJK)
and world-aware photorealism.

- FAL_MODELS entry with image_size_preset style
- 4:3 presets on all aspect ratios — 16:9 (1024x576) falls below
  GPT-Image-2's 655,360 min-pixel floor and would be rejected
- quality pinned to medium (same rule as gpt-image-1.5) for
  predictable Nous Portal billing
- BYOK (openai_api_key) deliberately omitted from supports so all
  users stay on shared FAL billing
- 6 new tests covering preset mapping, quality pinning, and
  supports-whitelist integrity
- Docs table + aspect-ratio map updated

Live-tested end-to-end: 39.9s cold request, clean 1024x768 PNG
Luminet2023 pushed a commit to Luminet2023/hermes-agent that referenced this pull request May 1, 2026
Adds OpenAI's new GPT Image 2 model via FAL.ai, selectable through
`hermes tools` → Image Generation. SOTA text rendering (including CJK)
and world-aware photorealism.

- FAL_MODELS entry with image_size_preset style
- 4:3 presets on all aspect ratios — 16:9 (1024x576) falls below
  GPT-Image-2's 655,360 min-pixel floor and would be rejected
- quality pinned to medium (same rule as gpt-image-1.5) for
  predictable Nous Portal billing
- BYOK (openai_api_key) deliberately omitted from supports so all
  users stay on shared FAL billing
- 6 new tests covering preset mapping, quality pinning, and
  supports-whitelist integrity
- Docs table + aspect-ratio map updated

Live-tested end-to-end: 39.9s cold request, clean 1024x768 PNG
Luminet2023 added a commit to Luminet2023/hermes-agent that referenced this pull request May 1, 2026
* upstream/main: (160 commits)
  feat(llm-wiki): port provenance markers, source hashing, and quality signals from llm-wiki-compiler (NousResearch#13700)
  fix(vision): restore tier-aware Nous vision model selection (NousResearch#13703)
  fix(vision): route Nous main-provider vision through tier-aware backend
  test(approval): regression guards for thread-local callback contract
  fix(security): TUI approval overlay accepts blind keystrokes, CLI thread-local callback invisible to agent
  chore(release): add Ifkellx to AUTHOR_MAP for PR NousResearch#12687
  fix(vision): resolve Nous vision model correctly in auto-detect path
  docs(delegate): clarify that the parent agent, not the user, populates goal/context (NousResearch#13698)
  fix(auxiliary): refresh Nous runtime credentials after aux 401s
  feat(delegate): orchestrator role and configurable spawn depth (default flat)
  fix(tui): inject VS16 so text-default emoji render as color glyphs
  feat(gateway): recognize .pdf in MEDIA: tag extraction (NousResearch#13683)
  test(delegate): make default_toolsets regression test robust to user config
  docs(delegate): remove default_toolsets from example config and docs
  refactor(delegate): drop dead default_toolsets from CLI default config
  feat(image-gen): add GPT Image 2 to FAL catalog (NousResearch#13677)
  fix(gateway): always inject reply-to pointer, not just when quoted text is absent (NousResearch#13676)
  fix(skills/llama-cpp): concise description, restore python bindings, fix curl
  improve llama.cpp skill
  fix(tui): route skills.manage through the long-handler thread pool
  ...

# Conflicts:
#	tools/file_tools.py
#	uv.lock
02356abc pushed a commit to 02356abc/hermes-agent that referenced this pull request May 14, 2026
Adds OpenAI's new GPT Image 2 model via FAL.ai, selectable through
`hermes tools` → Image Generation. SOTA text rendering (including CJK)
and world-aware photorealism.

- FAL_MODELS entry with image_size_preset style
- 4:3 presets on all aspect ratios — 16:9 (1024x576) falls below
  GPT-Image-2's 655,360 min-pixel floor and would be rejected
- quality pinned to medium (same rule as gpt-image-1.5) for
  predictable Nous Portal billing
- BYOK (openai_api_key) deliberately omitted from supports so all
  users stay on shared FAL billing
- 6 new tests covering preset mapping, quality pinning, and
  supports-whitelist integrity
- Docs table + aspect-ratio map updated

Live-tested end-to-end: 39.9s cold request, clean 1024x768 PNG
gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026
Adds OpenAI's new GPT Image 2 model via FAL.ai, selectable through
`hermes tools` → Image Generation. SOTA text rendering (including CJK)
and world-aware photorealism.

- FAL_MODELS entry with image_size_preset style
- 4:3 presets on all aspect ratios — 16:9 (1024x576) falls below
  GPT-Image-2's 655,360 min-pixel floor and would be rejected
- quality pinned to medium (same rule as gpt-image-1.5) for
  predictable Nous Portal billing
- BYOK (openai_api_key) deliberately omitted from supports so all
  users stay on shared FAL billing
- 6 new tests covering preset mapping, quality pinning, and
  supports-whitelist integrity
- Docs table + aspect-ratio map updated

Live-tested end-to-end: 39.9s cold request, clean 1024x768 PNG
waefrebeorn pushed a commit to waefrebeorn/slermes that referenced this pull request Jul 2, 2026
Adds OpenAI's new GPT Image 2 model via FAL.ai, selectable through
`hermes tools` → Image Generation. SOTA text rendering (including CJK)
and world-aware photorealism.

- FAL_MODELS entry with image_size_preset style
- 4:3 presets on all aspect ratios — 16:9 (1024x576) falls below
  GPT-Image-2's 655,360 min-pixel floor and would be rejected
- quality pinned to medium (same rule as gpt-image-1.5) for
  predictable Nous Portal billing
- BYOK (openai_api_key) deliberately omitted from supports so all
  users stay on shared FAL billing
- 6 new tests covering preset mapping, quality pinning, and
  supports-whitelist integrity
- Docs table + aspect-ratio map updated

Live-tested end-to-end: 39.9s cold request, clean 1024x768 PNG
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/tools Tool registry, model_tools, toolsets tool/vision Vision analysis and image generation type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants