leon-llb/codex-image

Analysis updated 2026-06-24

★ 14PythonAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

Mindmap

mindmap
  root((codex-image))
    Inputs
      Prompt string
      Image size
      Output dir
    Outputs
      PNG file in folder
      Timestamped filename
    Use Cases
      Free image generation
      Claude Code skill
      Hermes chat plugin
    Tech Stack
      Python
      Codex CLI
      ChatGPT Plus
    Limits
      macOS only
      Requires Plus plan

mindmap root((codex-image)) Inputs Prompt string Image size Output dir Outputs PNG file in folder Timestamped filename Use Cases Free image generation Claude Code skill Hermes chat plugin Tech Stack Python Codex CLI ChatGPT Plus Limits macOS only Requires Plus plan

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Generate images from the terminal with python3 generate.py and a prompt

USE CASE 2

Add image generation to Claude Code by dropping the skill into the skills directory

USE CASE 3

Wire image generation into a Hermes Telegram or WeChat agent via the plugin file

USE CASE 4

Avoid OpenAI API billing by routing image requests through ChatGPT Plus

What is it built with?

PythonCodex CLIChatGPT

How does it compare?

	leon-llb/codex-image	0c33/agentic-ai	albertusreza/pr-pilot
Stars	14	14	14
Language	Python	Python	Python
Setup difficulty	moderate	hard	easy
Complexity	2/5	4/5	2/5
Audience	vibe coder	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Only works on macOS and needs an active ChatGPT Plus subscription plus Codex.app installed.

MIT license, so you can use, modify, and ship it with almost no restrictions as long as you keep the copyright notice.

In plain English

Codex Image is a small Python helper that lets command-line tools and AI agents generate images for free by routing the request through your existing ChatGPT Plus subscription. The author's pitch is that you do not need an OpenAI API key, you do not pay per image, and you do not go through a third-party proxy. Instead it piggybacks on a separate macOS desktop app called Codex.app, which ships its own codex CLI that already talks to ChatGPT. A comparison table sets out the trade-off. With Codex Image the cost is included in your Plus plan, you get the ChatGPT native image model with its text-rendering quality, and setup is a single git clone. The trade-off is that this only works on macOS, because Codex.app is macOS-only, and you still need an active ChatGPT Plus subscription. Usage is direct. After cloning the repo into your skills directory, you run python3 generate.py with a prompt string, an optional size like 1024x1024, and an optional output directory. The README gives three example prompts for a square shiba inu illustration, a portrait cinematic shot, and a landscape cyberpunk wallpaper. Files are saved with a timestamped filename like codex-image-20260518-143052.png. The project also documents two integrations. The first is Claude Code, Anthropic's coding assistant: dropping the skill into the skills directory makes it discoverable, and saying generate an image of in conversation triggers it. The second is Hermes, also called OpenClaw Agent, which is a Telegram and WeChat chat agent. There are step-by-step instructions for copying a plugin file into the Hermes config, enabling the plugin in config.yaml, and restarting the gateway so chat messages can request images. The How it works diagram traces the flow from user, to Hermes or Claude, to an image_generate tool call, to the codex-image provider, to generate.py, to a codex exec call against ChatGPT Plus, and finally an image saved to ~/Downloads. The project is MIT licensed.

Copy-paste prompts

Prompt 1

Walk me through installing codex-image and generating my first 1024x1024 image

Prompt 2

Write a config snippet that registers codex-image as a Hermes plugin in config.yaml

Prompt 3

Show me how to call generate.py from a shell script and save outputs to a custom folder

Prompt 4

Explain how codex-image routes the request from Hermes through Codex.app to ChatGPT

Frequently asked questions

What is codex-image?

A Python skill that generates images via your ChatGPT Plus subscription by piggybacking on the macOS Codex.app CLI, so you skip the OpenAI API and per-image fees.

What language is codex-image written in?

Mainly Python. The stack also includes Python, Codex CLI, ChatGPT.

What license does codex-image use?

MIT license, so you can use, modify, and ship it with almost no restrictions as long as you keep the copyright notice.

How hard is codex-image to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-image for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.