Image Forge documentation
Bulk AI image generation from a spreadsheet, using your own API keys. No account, no server, no subscription — your keys stay on your machine.
Download for Windows View on GitHub
Start where you are
Three kinds of reader. Pick yours.
For everyone
No code and no terminal. Words like “API key” are explained the first time.
| Guide | For you if |
|---|---|
| Download and install | You are on Windows and want to double-click something. |
| Your first pictures | You want to make pictures and have never set up an engine. |
| Sheets, GIFs and lettering | You want sprite sheets, talking avatars, GIFs and text on surfaces. |
For vibe coders
| Guide | For you if |
|---|---|
| Agents and the manifest | You want an agent to fill the manifest and run the forge. |
For developers
| Guide | For you if |
|---|---|
| How it is built | You want the architecture, how to add an engine, and how to release. |
Reference
| Page | What is in it |
|---|---|
| The manifest | Every column, what it does, what happens if you leave it out. |
| Troubleshooting | Real failures, what causes them, and what to do. |
| What changed | Every release, and what was actually wrong. |
The idea in one paragraph
The unit of work is a spreadsheet row. One row is one picture: a filename, a prompt, a shape, a seed, and which engine should paint it. You fill in rows — by hand, from a CSV, with a wizard, by asking the chat, or by letting an agent do it — and press Run queue. Images come out named and sorted into folders, and the CSV records what happened to each one. Anything that can read and write that CSV is a first-class citizen of the project.
What it costs
Nothing, if you want. These engines are free:
| Engine | Free allowance | Needs |
|---|---|---|
| OVHcloud SDXL | two a minute, always square | nothing — no key, no signup |
| Cloudflare Workers AI | ~690 images a day | a free account, no card |
| Pollinations | unlimited, ~one per 5s | a free token |
| Your own machine (LocalAI and similar) | unlimited, private, offline | a graphics card and the software |
Paid engines exist and are never used without asking first. Before a paid run you get how many pictures will be billed, the model, the price each, the total, and which credit pays for it — with a button to switch to a free engine instead.
Writing, code and vision models can be free too: one Mistral key covers all three.
Honest limitations
- Windows gets packaged builds. Mac and Linux run from source.
- The app is not code-signed, so Windows shows a warning on first run. What to click.
- Most image models cannot spell. Use a Nano Banana model for words in a picture, or add text yourself with the Letterer.
- It cannot fix a provider outage or an empty account — but it will tell you which one it is, and offer a free engine instead.
Licence
Apache-2.0. Use it, sell what you make with it, build on it. If you redistribute it, the NOTICE file travels with it. Just using the app carries no obligation.