ima2-gen
EN KO
GitHub ↗
Local image studio · Classic + Node

Branch the
images you
love.

An image studio for the way you actually iterate. Generate in Classic, fan out variations in a Node graph — palette, framing, copy — without losing the parent frame.

$ npx ima2-gen serve
한국어 README →
ima2-gen Classic mode showing the prompt composer, generated image, model label, and result metadata.
01 · Two ways to make

Two ways to make. One way to branch.

Classic for one strong frame. Node for a tree of variations from a parent you locked in. Pick the workflow your idea wants.

ima2-gen Classic mode with prompt composer, references, and a generated team portrait.
Classic

One prompt, one strong frame.

Write, attach up to five references, generate. Iterate until it lands. Continue from any result.

ima2-gen Node mode with connected generated cards and per-node metadata.
Node

One frame, ten directions.

Lock a parent. Fan out children — palette, framing, copy. Compare side by side. Never lose the original.

02 · Branching as a workflow

A good frame is a starting point.

Locking the parent and fanning out children is how visual ideas actually develop. ima2-gen makes it the default.

ima2-gen Node mode canvas with a parent node and child branches showing palette, framing, and copy variants.
  1. 01
    Generate a parent. A frame you actually want to keep.
  2. 02
    Fan out children. Palette swap, tighter crop, alternate copy margin — three nodes, three runs.
  3. 03
    Compare without loss. The parent stays. Children recover by request ID even after a refresh.
03 · Local & open
ima2-gen Settings workspace showing OAuth active and an API key configured but disabled.

Sign in. Stay local.

ima2-gen reuses your existing Codex/ChatGPT login. Generated frames and sessions live on your disk — not on someone else's.

If the settings page says Configured but disabled, that means an API key exists in env/config but image generation still uses OAuth.

User-data folder · MIT licensed · Inspect, sync, version — your call.

04 · Visual memory

Capture the look. Reuse it everywhere.

Style sheets pin medium, composition, mood, palette, and negatives. References attach up to five inputs and persist across sessions.

  • medium
  • composition
  • mood
  • subject
  • palette
  • negative
ima2-gen Style sheet editor with medium, composition, mood, subject, palette, and negative fields.
05 · Get going

One command. Then iterate.

Run it with npx. Sign in once with Codex. Start branching.

$ npx ima2-gen serve
$ npm install -g ima2-gen
$ npx @openai/codex login
npm v1.1.0 Node ≥20 MIT
FAQ
When should I use Node mode?

When you want to compare several directions from a result you like. Vary the prompt, framing, or palette per node while the original frame stays put. Children survive a page refresh — they recover by request ID.

Where do my images live?

Locally. Generated images and session logs live in your user-data folder. Inspect, sync, version — your call. Image files are not uploaded to a separate remote store.

Do I need an OpenAI API key?

Not for image generation. ima2-gen uses your local Codex/ChatGPT login. An API key may still be detected for auxiliary tooling, but the generation path uses your login session by design.

See all FAQ →