MohamedAbdallah-14/prompt-to-asset

Free image generation for developers, from the CLI or your AI assistant.
Turn one brief into app icons, favicons, OG images, logos, splash screens, SVG, and platform bundles using the best zero-cost routes first.
Built for Cloudflare Workers AI, NVIDIA NIM, HF Inference, Stable Horde, Pollinations, free trials, and offline SVG.
Quickstart ·
Free paths ·
Usage ·
Modes ·
Free APIs ·
MCP tools ·
Full guide ·
Changelog
---
30-second start
**Pick one. Run it. You're done.** The recommended path is first.
Runtime: **Node ≥ 20.11** (24 recommended). macOS, Linux, Windows (WSL2 for --fix native deps).
🔵 AI assistant · recommended
Click an install button above. Then paste one of these into chat:
Works in Cursor, Claude Code, VS Code, Windsurf, Codex, Gemini CLI. Zero terminal typing.
🟢 Zero key, zero install
One curl, one npx. Offline fan-out to every platform.
Outputs: iOS AppIconSet, Android adaptive, PWA, favicon bundle, visionOS scaffold.
🟣 CLI · free API keys
Best CLI experience: free tokens first, paid keys optional.
Start with Cloudflare Workers AI, NVIDIA NIM, HF Inference, Stable Horde, and free trials. Paid providers remain optional fallbacks.
Free paths at a glance
You don't need a paid API key. Ranked best-first:
| Route | Gets you | Signup |
| ------------------------------------ | -------------------------------------- | ----------------------- |
| **inline_svg** via AI assistant | Logos, favicons, icon packs — instant | None |
| **Cloudflare Workers AI** | Flux-1-Schnell + SDXL, 10k neurons/day | Free token + account ID |
| **NVIDIA NIM** | Flux.1-dev, Flux.2-klein, SDXL, SANA | Free token, no card |
| **HF Inference** | SDXL, SD3, Flux dev/schnell | Free read token |
| **Stable Horde** | SDXL, Flux on community GPUs | Anonymous queue |
| **Pollinations** (HTTP GET) | Last-resort raster, RGB | None |
| **Google AI Studio** (paste-only UI) | Nano Banana / Nano Banana Pro | Google account |
Details + quotas: Free paths beyond Pollinations. Run p2a doctor or ask your assistant for asset_doctor() to see what's live right now.
> [!TIP]
> Stuck? Click **Install in Cursor** or **Install in VS Code** above, restart the editor, and say: _"make a favicon for my app, dark-mode aware."_
---
Highlights
- **Free CLI-first generation** — p2a doctor, p2a pick, and the MCP tools rank free API routes before paid models, so developers can generate inside the CLI without enabling billing.
- **Three execution modes** — inline_svg (host LLM authors SVG), external_prompt_only (paste into any web UI), api (server calls a free or paid provider). Pick what fits. All three can finish on $0.
- **60+ models, free-first routing** — Cloudflare Workers AI, NVIDIA NIM, HF, Horde, Pollinations, free trials, plus optional paid OpenAI / Ideogram / Recraft / BFL / Gemini. Each rule cites a research source.
- **Refuses to do the wrong thing** — the Never column. No wordmarks past 3 words through a diffusion sampler. No transparent PNG through Imagen. No negative_prompt on Flux.
- **Offline platform fan-out** — one 1024² master → iOS AppIconSet, Android adaptive + monochrome, PWA 192/512/512-maskable, favicon bundle, visionOS parallax, Flutter launcher. Zero network.
- **Validates before shipping** — tier-0 checks on every output: dims, alpha presence, checkerboard FFT, safe-zone bbox, ΔE2000 palette drift, WCAG contrast, OCR Levenshtein on wordmarks.
- **Sprite sheets + 9-slice** — pack PNG frames into TexturePacker-compatible atlases (Phaser, PixiJS, Godot, Unity); emit 9-slice numbers + CSS border-image + Android .9.png.
---
Table of contents
Click to expand
- 30-second start
- Usage — what to say to your assistant
- The three modes — inline_svg · external_prompt_only · api
- The router — which model for which job, and what never
- Free paths beyond Pollinations
- Install
- Models covered — 60+
- MCP tools — 25 tools
- CLI surface
- Brand bundle (brand.json)
- Platform support
- Architecture
- Comparison
- Security
- Research-backed decisions
- Development
- Community · License
---
Usage
You just talk to your assistant. Example from a new chat:
> **Make me a transparent logo for a developer-tools company called Forge. Flat vector, two-tone warm orange on neutral.**
Behind the scenes:
1. **asset_doctor()** — check what modes and providers are live.
2. **asset_init_brand({ app_name: "Forge", palette: ["#EA580C", "#F5F5F4"] })** if no brand.json exists.
3. **asset_enhance_prompt({ brief })** returns an AssetSpec: classification, rewritten prompt, modes_available[], optional svg_brief, optional paste_targets, and a routing_trace pointing at the research file that backed the decision (plus never_models — why Imagen or DALL·E got rejected).