alex-karev/intel-image-generator

Intel 画像ジェネレーター

scripts/ はこのファイルからの相対パスで解決します。ユーザーのワークスペース内の絶対パスを出力先として使用してください。

まず選択内容を確認する

生成を行う前に、生成時に使用する予定のモデル/デバイスオプションを指定して --info を実行してください：

SKILL_DIR="/absolute/path/to/intel-image-generator"
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator --info

これにより、device と model を含むJSONが出力されます。モデルのダウンロード、検証、コンパイル、実行は行われません。選択されたデバイスとモデルがユーザーのリクエストおよび以下の互換性テーブルと一致していることを確認してください。--info が成功したからといって、テストされていないモデルが動作すると主張しないでください。ユーザーからオーバーライドのリクエストがない限り、報告されたモデルを使用してください。異なるモデルを黙って代用しないでください。

その後、同じオプション、プロンプト、出力先を使用して生成を実行します。--device を省略すると自動選択が維持され、ユーザーが明示的に要求した場合にはデバイスを指定します：

env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator \
  --size 512x512 --seed 42 --steps 20 \
  -p "フレンドリーなゾウ、フラットイラスト" \
  -o /absolute/path/to/output.png

終了ステータスと出力ファイルが存在することを確認し、そのパスを返してください。モデルやデバイスのオプションを変更する場合は、最初に --info を再実行してください。

オプション

--info（ロングオプションのみ）はプロンプトや出力を必要としません。生成には -p/--prompt TEXT または -i/--input PATH（UTF-8、空でない行ごとに1プロンプト）のうち正確に1つと、-o/--output PATH が必要です。ファイルからのプロンプトは順次生成され、プロンプトごとに1つの画像が作成され、複数の画像は stem-1.ext、stem-2.ext のように保存されます。各ファイルはアトミックに書き込まれ、すべての出力先は事前に検証されます。失敗した実行では、それ以前に完了した画像が保持される可能性があります。-m/--model NAMESPACE/REPOSITORY で互換性のあるモデルを選択し、--model-dir PATH でローカルエクスポートを選択します（相互に排他的）。その他のオプション：--size WIDTHxHEIGHT、--seed INTEGER、--steps INTEGER、--device NPU|GPU|CPU。

参照画像による条件付けには、-r/--reference PATH を --model stable-diffusion-v1-5/stable-diffusion-v1-5 と共に使用します。これはテキストから画像へのIP-Adapterを使用しており、img2imgではありません。キャラクターの同一性や正確なスタイルを保証するものではありません。--source、--strength、または --model-dir と組み合わせることはできません。必要なモデルは、それがデフォルトであっても明示的に指定する必要があります（NPUのデフォルトが異なる場合も同様です）。初回使用時には数GBのダウンロードが発生し、個別のエクスポートが作成されます。モデルを黙って変更しないでください。

img2img には、開始画像として -s/--source PATH を、オプションで --strength FLOAT（0より大きく最大1、デフォルト0.75）を使用します。--strength は --source を必要とします。--style は削除されました。-r は参照条件付けを選択し、-s はimg2imgソースを選択します。

--device を指定しない場合、統合Intel GPUシステムは NPU → GPU → CPU の優先順位を、ディスクリートIntel GPUシステムは GPU → NPU → CPU の優先順位を採用します。未知のGPUタイプまたはGPUプロパティ検出の失敗はCPUにフォールバックします。明示的な選択は厳格に適用されます。コンパイル/推論エラーが発生してもデバイスの再試行は行われません。

NPU モデル互換性

以下は、このスキルにおける単一のモデル互換性リストです。エビデンスは正確なモデルとソフトウェア設定に適用され、すべての派生モデルに適用されるわけではありません。

Hugging Face モデル	このCLIにおけるNPUステータス
stable-diffusion-v1-5/stable-diffusion-v1-5	CPU/GPU デフォルト；NPUテスト済み： ローカルにエクスポート済み；Lunar Lake Intel AI Boost + OpenVINO 2026.4.1 / Optimum Intel 1.27.0 で生成成功。
OpenVINO/stable-diffusion-v1-5-fp16-ov	互換性のあるSDパイプラインの候補；ここではNPU未テスト。コンパイル成功を約束しないでください。
OpenVINO/stable-diffusion-v1-5-int8-ov	NPU デフォルト；Lunar Lake + OpenVINO 2026.4.1 / Optimum Intel 1.27.0 で1枚の画像生成成功。
Intel/sd-1.5-square-quantized	Intelのカード名はNPUですが、リポジトリには必要なDiffusersの model_index.json/コンポーネントレイアウトがありません。このCLIの --model では直接使用できません。

SDXL と FLUX は別のパイプラインサポートを必要とするため、このCLIではNPUの代替として選択できません。互換性をテストするためだけに、自動的に候補をダウンロードしないでください。

モデルセーフティチェッカーは無効化されています。セットアップ、初回実行時のコスト、モデル/ライセンスの詳細、トラブルシューティングについては README.md を参照してください。CPUへの黙示的なフォールバックや承認されていないシステム/ドライバーの変更を行わないでください。