prompt-to-asset

prompt‑to‑asset

開発者向けの無料画像生成。CLI または AI アシスタントから利用できます。
1つの概要から、アプリアイコン、ファビコン、OG画像、ロゴ、スプラッシュ画面、SVG、プラットフォーム別の一式を生成します。まずは最適な無料ルートを利用します。
Cloudflare Workers AI、NVIDIA NIM、HF Inference、Stable Horde、Pollinations、無料トライアル、オフライン SVG 向けに構築されています。

_{クイックスタート · 無料の方法 · 使い方 · モード · 無料 API · MCP ツール · 完全ガイド · 変更履歴}

30秒で開始

どれか1つ選んで実行するだけです。これで完了です。 推奨の方法を最初に紹介します。

実行環境：Node ≥ 20.11（24を推奨）。macOS、Linux、Windows（--fix のネイティブ依存関係には WSL2 を使用）。

• Make a transparent logo for Forge, a dev-tools brand. Flat vector, warm orange.
• Make a favicon for my app, dark-mode aware.
• Fan this master.png out to iOS + Android + PWA.
• Ingest this screenshot as a mark, vectorize, export everything.

curl -o logo.png \
  "https://image.pollinations.ai/prompt/\
minimal+flat+vector+logo\
?model=flux&width=1024&nologo=true"

npx prompt-to-asset export logo.png \
  --platforms ios,android,pwa,favicon

npm i -g prompt-to-asset
p2a doctor          # check env
p2a doctor --fix    # auto-install deps
p2a pick            # interactive

無料で使える方法の概要

有料 API キーは不要です。おすすめ順に並べています：

詳細とクォータ：Pollinations 以外の無料利用方法。p2a doctor を実行するか、アシスタントに asset_doctor() を依頼すると、現在利用可能なものを確認できます。

ヒント

行き詰まった場合は、上の Install in Cursor または Install in VS Code をクリックし、エディターを再起動して、次のように入力してください：「アプリ用のファビコンを作成して。ダークモードにも対応させて。」

主な機能

• 無料、CLI 優先の生成 — p2a doctor、p2a pick、および MCP ツールは有料モデルより先に無料の API 経路を優先するため、開発者は課金を有効にせずに CLI 内で生成できます。
• 3 つの実行モード — inline_svg（ホスト LLM が SVG を作成）、external_prompt_only（任意のウェブ UI に貼り付け）、api（サーバーが無料または有料のプロバイダーを呼び出し）。用途に合わせて選べます。3 つすべて、費用 0 ドルで完了できます。
• 60 以上のモデル、無料優先のルーティング — Cloudflare Workers AI、NVIDIA NIM、HF、Horde、Pollinations、無料トライアルに加え、オプションで有料の OpenAI / Ideogram / Recraft / BFL / Gemini も利用できます。各ルールには調査ソースが記載されています。
• 不適切な処理を拒否 — Never 列を参照してください。3 語を超えるワードマークを拡散サンプラーに通しません。透明 PNG を Imagen で生成しません。Flux に negative_prompt を指定しません。
• オフラインでのプラットフォーム一括出力 — 1024² のマスター画像 1 枚から、iOS AppIconSet、Android adaptive + monochrome、PWA 192/512/512-maskable、favicon バンドル、visionOS 視差画像、Flutter ランチャー用画像を生成します。ネットワーク接続は不要です。
• 出力前に検証 — すべての出力に対してティア 0 のチェックを実施：寸法、アルファチャンネルの有無、チェッカーボード FFT、安全領域のバウンディングボックス、ΔE2000 によるパレットのずれ、WCAG コントラスト、ワードマークの OCR Levenshtein。
• スプライトシート + 9 スライス — PNG フレームを TexturePacker 互換のアトラス（Phaser、PixiJS、Godot、Unity）にパックし、9 スライスの数値 + CSS border-image + Android .9.png を出力します。

目次

使い方

アシスタントに話しかけるだけです。新しいチャットでの例：

Forgeという開発者向けツール企業の、背景が透明なロゴを作ってください。フラットなベクターで、ニュートラルな色を背景に、温かみのあるオレンジを2色使ってください。

内部では、次の処理が行われます。

1. asset_doctor() — 利用可能なモードとプロバイダーを確認します。
2. asset_init_brand({ app_name: "Forge", palette: ["#EA580C", "#F5F5F4"] }) — brand.jsonが存在しない場合に実行します。
3. asset_enhance_prompt({ brief }) はAssetSpecを返します。内容は、分類、書き換えられたプロンプト、modes_available[]、任意のsvg_brief、任意のpaste_targets、判断の根拠となった調査ファイルを示すrouting_trace（およびImagenやDALL·Eが却下された理由を示すnever_models）です。
4. アシスタントが**inline_svg／external_prompt_only／api**を提示します。
5. **inline_svg**の場合：<svg>をインラインで作成し、asset_save_inline_svgを呼び出します → master.svg、favicon.ico、apple-touch、AppIconSet、PWAバンドルをディスクに書き込みます。
6. **external_prompt_only**の場合：アシスタントが、調整済みプロンプトと最適な貼り付け先（無料のものを優先）を提示します。生成して保存した後、「このファイルを取り込んで」と伝えます → asset_ingest_external。
7. **api**の場合：アシスタントがルーティングされたプロバイダーを呼び出します。サーバーがマット処理、ベクター化、エクスポート、検証を行います。
8. 追加の依頼：「これをiOSとAndroid用にも展開してください」 → 保存済みのマスターを使ってasset_export_bundleを実行します。

CLIに入力する必要はありません。CI、シェルスクリプト、MCP以外の環境では、CLIも引き続き第一級の手段です。どちらのインターフェースも同じコアを利用します。

これが存在する理由

ここでのすべてを左右する事実が2つあります。

本番品質のソフトウェアアセットを作成するうえで重要なのは、プロンプトエンジニアリングではなく、ルーティングと後処理の問題です。

Imagen 3/4とGemini Flash Imageでは、本物のRGBA PNGを生成できません。VAEがRGB専用のため、透明な背景を求めると、灰色と白の市松模様が ピクセルとして 描画されます。SDXLは約8文字を超えると正確に文字を描けません。ネイティブSVGを出力できるのはRecraftだけです。Fluxはnegative_promptでエラーになります。こうした制約はモデルのUIからは見えません。しかし、どれも「プロンプト → アセット」を一度で実行するツールを、気づかれないまま破綻させます。

画像モデルのAPIキーを持っていない場合もあります。それでもこのプラグインは動作します。

3つのモードはいずれも、費用をかけずに完了できます。

3 つのモード

flowchart LR
    A["one-line brief"] --> B["asset_enhance_prompt"]
    B --> C{"mode"}
    C -->|inline_svg| D["Host LLM emits SVG inline<br/>→ asset_save_inline_svg"]
    C -->|external_prompt_only| E["Paste into web UI<br/>→ asset_ingest_external"]
    C -->|api| F["Server calls routed provider"]
    D --> G["matte · vectorize · validate"]
    E --> G
    F --> G
    G --> H["AssetBundle<br/>ios · android · pwa · favicon · visionos · flutter"]

ホスト LLM がモードを選ぶことも、自分で選ぶこともできます。サーバーは modes_available を公開し、アシスタントが選択肢を提示できるようにします。常に無料の選択肢を優先します。

ルーター

ルーターの判断は data/routing-table.json に記載されています。機能マトリクスは data/model-registry.json にあります。すべてのルールには調査元が記載されています。

使用しないものの列は重要です。これがあるため、prompt-to-asset は拡散サンプラーで 3 語を超えるワードマークを生成せず、透明な PNG を求めた場合に Imagen が選ばれることもありません。

Pollinations 以外の無料の選択肢

p2a doctor を実行するか、アシスタントに asset_doctor() を依頼すると、現在の環境で利用できるものを確認できます。

インストール

すべてのコマンドは npx 経由で動作するため、インストールは不要です。

# Zero install
npx prompt-to-asset doctor           # what's live in this shell right now
npx prompt-to-asset doctor --fix     # auto-install native deps (brew / cargo / scoop; never sudo)
npx prompt-to-asset pick             # interactive route picker
npx prompt-to-asset init --register  # scaffold brand.json + register in .cursor / .vscode / .windsurf

# Or global for daily use
npm i -g prompt-to-asset
p2a doctor

# Or per-project for CI
npm i -D prompt-to-asset

AI アシスタントに登録する

claude mcp add prompt-to-asset -- p2a

npx -y @smithery/cli install prompt-to-asset --client claude

登録すると、アシスタントから 24 個の asset_* ツールをすべて利用できるようになります。

対応モデル

有料の直接 API： gpt-image-1、gpt-image-1.5、dall-e-3（2026-05-12 に非推奨）、imagen-3、imagen-4、gemini-3-flash-image（Nano Banana）、gemini-3-pro-image、sd-1.5、sdxl、sd3-large、playground-v3、flux-schnell、flux-dev、flux-pro、flux-2、flux-kontext-pro、ideogram-3、ideogram-3-turbo、recraft-v3、leonardo-phoenix、leonardo-diffusion-xl、fal-flux-pro、fal-flux-2、fal-sdxl。

無料枠／キー不要： pollinations-flux、pollinations-turbo、pollinations-kontext、pollinations-sd、horde-sdxl、horde-flux、hf-sdxl、hf-sd3、hf-flux-schnell、hf-flux-dev。

プロンプト貼り付け専用のモデル： midjourney-v6、midjourney-v7、firefly-3、krea-image-1。貼り付け専用のプライマリモデルに対して mode: "api" を指定して asset_generate_* を呼び出すと、API で利用可能なチェーン内の最初のモデルにソフトフォールバックし、警告が表示されます。チェーン全体が貼り付け専用の場合は、エラーではなく ExternalPromptPlan が返されます。

p2a                          # default — MCP stdio server
p2a mcp                      # same, explicit
p2a export <master.png>      # offline platform fan-out
p2a export <master.png> --json
p2a init                     # interactive brand.json + IDE registration hints
p2a init --register          # + auto-write .cursor/mcp.json / .vscode/mcp.json / .windsurf/mcp.json
p2a pick                     # interactive model picker
p2a doctor                   # environment inventory
p2a doctor --json            # structured output
p2a doctor --data            # check data/model-registry.json ↔ data/routing-table.json consistency
p2a doctor --fix             # auto-install missing native deps (brew / cargo / scoop; never sudo)
p2a models list              # --free | --paid | --paste-only | --rgba | --svg
p2a models inspect <id>      # full capability dump
p2a sprite-sheet <dir>       # pack frames → PNG + atlas
p2a nine-slice <image>       # 9-slice JSON + CSS + engine numbers + .9.png
p2a --help

{
  "name": "Halcyon",
  "palette": ["#2563eb", "#ffffff"],
  "fonts": { "display": { "family": "Inter", "weights": [700, 800] } },
  "style_refs": ["https://…/sample1.png", "./refs/style2.png"],
  "do_not": ["drop shadows", "heavy gradients"],
  "lora": "halcyon-flux-v2",
  "sref_code": "--sref 1234567890",
  "style_id": "rc_halcyon_01"
}

  brief (text)
    ↓  asset_capabilities         → modes available + free/paid/paste-only bucketing
    ↓  asset_enhance_prompt       → AssetSpec {
    ↓                                  routing_trace: { rule_id, reason, research_sources, never_models, fallback_chain },
    ↓                                  modes_available,
    ↓                                  svg_brief?,         (inline_svg)
    ↓                                  paste_targets?,     (external_prompt_only)
    ↓                                  rewritten_prompt, …
    ↓                                }
    ↓
    ├─ mode: inline_svg                → host LLM emits <svg>; asset_save_inline_svg writes bundle
    ├─ mode: external_prompt_only      → user pastes into web UI; asset_ingest_external runs matte → vectorize → validate
    └─ mode: api                       → provider(model, prompt, params) → matte → vectorize → upscale → export → validate

API キーはユーザーが管理します。それ以外はすべて LLM が担います。

ターミナルで行うのは、パッケージのインストールと .env へのキーの設定だけです。シークレットをチャットに通すべきではありません。それ以外の操作――doctor のチェック、モデルの調査、プラットフォームへの一括展開、ブランドのひな形作成、スプライトシート、9 スライスの設定――はすべて、自然言語で依頼するとアシスタントが呼び出す MCP ツールです。

比較

セキュリティ

このツールは最大 15 プロバイダーの API キーを扱います。譲れない原則は次のとおりです。

• キーは環境変数にのみ保存します。 ディスクへの書き込み、ログへの記録、MCP レスポンスでの返却は一切行いません。プロバイダーのエラーボディは、ホスト LLM に渡す前に redact()（packages/mcp-server/src/security/redact.ts）を通します。
• パスへのアクセスは許可リストで制限します。 image_path / output_dir / existing_mark_svg はシンボリックリンクを解決し、プロジェクトの cwd、設定済みの出力ディレクトリ、キャッシュディレクトリ、OS の一時ディレクトリの範囲外を拒否します。P2A_ALLOWED_PATHS=/path1:/path2 で許可範囲を広げられます。
• SVG は書き込む前に XSS 対策のサニタイズを行います。 <script>、<foreignObject>、on*= ハンドラー、javascript: URI、外部の <image href> / <use href>、ネットワーク経由の CSS @import はすべて拒否されます。このチェックは常に実行され、SVGO は必要ありません。
• コストの上限を設定できます。 P2A_MAX_SPEND_USD_PER_RUN=5.00 を設定すると、1 回のツール呼び出しに上限を設けられます。事前見積もりが上限を超える場合、呼び出しは拒否されます。無料枠のルートは常に $0 です。
• 起動時にデータの整合性を確認します。 起動時に assertDataIntegrityAtBoot() を実行します。ルーティングルールがレジストリに存在しないモデル ID を参照している場合、明確なエラーを表示してサーバーの起動を拒否します。p2a doctor --data を使って CI で確認できます。
• テレメトリーはありません。ルーティング先のプロバイダーが明示的に必要としない限り、リモート呼び出しは行いません。

ポリシーの全文：SECURITY.md。

調査に基づく決定

実装されているルーティングルール、文体の切り替え、安全領域のサイズ、テキストの上限は、いずれも docs/research/ 内のファイルに裏付けられています。asset_enhance_prompt は呼び出しごとに routing_trace.research_sources 配列を返します。観点からコードへの対応表と、実装済みの内容および保留中の内容を正直に記録した一覧は、docs/RESEARCH_MAP.md にあります。

開発

git clone https://github.com/MohamedAbdallah-14/prompt-to-asset.git
cd prompt-to-asset
npm install
npm run build
npm run typecheck
npm run lint
npm test               # vitest watch
npm run test:run       # vitest run (CI)
npm run smoke          # list tools via MCP stdio + correctness assertions
npm run sync           # regenerate IDE mirrors from SSOTs
npm run verify         # byte-verify mirrors match SSOTs

SSOT は skills/*/SKILL.md、rules/*.md、.claude-plugin/、data/*.json にあります。.cursor/、.claude/、.windsurf/ を直接編集しないでください。これらは scripts/sync-mirrors.sh と CI によって再生成され、バイト単位で検証されます。

• コントリビューションの流れ： CONTRIBUTING.md
• ユーザー向けの導入ガイド： GETTING_STARTED.md
• よくある問題： TROUBLESHOOTING.md
• リリースノート： CHANGELOG.md

コミュニティ

• イシューと機能リクエスト： GitHub Issues
• セキュリティに関する報告： SECURITY.md
• 行動規範： CODE_OF_CONDUCT.md
• スターの履歴：

このリポジトリのおかげで AppIconSet を手作業で作る手間が省けたなら、スターを付けていただくと、同じ課題に取り組むほかの開発者にもこのプロジェクトが届きやすくなります。

もっと読む

この設計の背景を詳しく紹介しています。

• 画像モデルを選ぶのをやめて、代わりにルーターを作った理由 — 30 種類以上の画像モデルを使い分ける利点について。
• MCP サーバーのアーキテクチャ：prompt-to-asset の内部構造 — アーキテクチャを詳しく解説します。

Medium と dev.to にも掲載しています。

ライセンス

MIT © prompt-to-asset のコントリビューター。