egotoadcitadel/palette-from-image-ai

AI coloring palette-from-image generator for designers and pixel artists — pull a clean named palette straight from any image, no subscription or cloud upload.

🎨 Palette‑From‑Image‑AI とは？

Windows専用のポータブルデスクトッププログラムで、写真、スクリーンショット、ゲームテクスチャ、絵画など、あらゆる画像をすぐに使えるカラーパレットに変換します。オフラインで推論を行い、オンデバイスビジョンモデルがまず画像を意味のある領域（空、地面、被写体など）にセグメント化し、その後、知覚的距離指標（LAB空間のCIEDE2000）を使用して色をクラスタリングします。結果は、5〜16個のスウォッチからなる小さな順序付きセットで、それぞれが自動的にラベル付けされ（ベース、アクセント、シャドウ、ハイライト）、HEX、CSS変数、Adobe ASE、GIMP GPL、JSON、PNGスウォッチシート、SVGなど、12の形式でエクスポートできます。

⚙️ コアアーキテクチャ（READMEに記載）

コンポーネント	役割
オンデバイスビジョンモデル	入力画像のセマンティックセグメンテーションを実行します。
知覚的カラー量子化器	生のRGBではなく、CIEDE2000（LAB）を使用して色をクラスタリングします。
リージョンサンプラー	セグメントごとに色をサンプリングし、面積で重み付けして、各領域に公平な影響を与えます。
ハーモニーエンジン	必要に応じて、パレットをカラーハーモニースキーム（類似、補色、トライアド、分割補色）にスナップします。
ロールタガー	機能タグ（ベース、アクセント、シャドウ、ハイライト、ニュートラル）を自動的に割り当てます。
エクスポートレイヤー	パレットを12種類のファイル形式（業界標準のスウォッチ形式を含む）で書き出します。
GPUパス（DX12）	大きな画像向けのオプションのDirectX 12コンピュートアクセラレーション（4Kで約1秒）。
CLIラッパー	コマンドライン引数によるスクリプト作成を可能にします。

これらのすべてが単一の**.exe**にバンドルされています。インストーラーも、ランタイム依存関係も、ネットワークトラフィックもありません。

🚀 主な機能（ユーザー向け）

機能	説明
リージョン認識抽出	セマンティック領域ごとに色をサンプリングし、単純なピクセル頻度法にありがちな重複スウォッチを回避します。
知覚的クラスタリング	CIEDE2000を使用するため、人間には同じに見える色がマージされます。
ロールタギング	各スウォッチにラベル（ベース、アクセント、シャドウ、ハイライト）が付けられ、編集可能です。
ハーモニー制約	カラースキームを選択すると、エンジンがパレットをそのスキームに向けて調整します。
12のエクスポート形式	HEX、RGB、HSL、LAB、ASE、GPL、ACO、CSS変数、JSON、PNGシート、SVGシート、SKETCH。
バッチモード	フォルダーをドロップすると、アプリが画像ごとに1つのパレットを作成します（マルチスレッド）。
パレット差分	2つのパレットを比較して色の差分を確認できます。アートディレクションの追跡に便利です。
スウォッチロック	色（例：ブランドカラー）を固定し、その周りで残りを再抽出できます。
アイボールサンプラー	任意のピクセルをクリックして、その正確な値をスウォッチとして追加できます。
GPUトグル	高解像度画像の処理を高速化するためにDirectX 12コンピュートを有効にします。
ポータブルプロファイル	設定は実行ファイルの隣に配置されます。フォルダーをUSBスティックに移動してもすべて動作します。
CLIモード	スクリプト使用：`palette-from-image-ai.exe --input foo.png --count 8 --format css --out palette.css`。
ウォッチフォルダー	監視対象ディレクトリに配置された新しいファイルを自動処理します。

📦 はじめに（READMEからのクイックスタート手順）

GitHubのランディングページからzipをダウンロードします。.exeとmodels/フォルダーが含まれています。
アーカイブ全体を管理するフォルダーに解凍します（インストーラーは不要）。
.exeを実行します。初回起動時に小さなシェーダーキャッシュが作成されます（約3秒）。
画像をウィンドウにドロップするか、ファイル → 画像を開くを使用します。
スウォッチ数（5〜16）を調整し、ハーモニーモードを選択し、保持したい色をロックします。
必要な形式でエクスポートします。HEXはワンクリック、スウォッチの右クリックで値をコピーできます。

典型的なエンドツーエンド時間：1分未満、GPUアクセラレーション使用時は4K画像で約1.2秒です。

🛠️ システム要件（記載されているもの）

最小	推奨
Windows 10 21H2（64ビット）	Windows 11 23H2+
4コアCPU、SSE4.2	8コアCPU、AVX2
4 GB RAM	16 GB RAM
内蔵GPU（DX11）	専用DX12 GPU、4 GB VRAM
450 MBの空きディスク	1.2 GBの空き（SSD）

追加のランタイムは不要（.NET、Python、Nodeは不要）。アプリはユーザースペースで完全に実行されます。

📚 典型的なユースケース

シナリオ	Palette‑From‑Image‑AI が適している理由
ゲームアセットパイプライン – シェーダー用にASEパレットが必要。	直接ASEエクスポート、リージョン認識カラー、スプライトフォルダーのバッチ処理。
UI/UXデザイン – CSS用のカラー変数を生成。	CSS変数エクスポート、ハーモニーモード、ロールタグ（ベース/アクセント）。
ブランド一貫性のあるアートディレクション – ブランドカラーを固定しながらパレットを再導出。	スウォッチロック+再抽出、パレット差分で時間の経過に伴う変化を確認。
セキュアなスタジオ向けオフラインワークフロー – アセットをアップロードできない。	完全オフライン、テレメトリなし、ポータブルフォルダー。
スクリプト/CI – パレットを自動生成。	CLIモードとウォッチフォルダー自動化。

📌 制限事項と既知の問題（READMEより）

初回起動時に、バイナリが署名されていないためSmartScreen警告が表示されます。
非常に大きなTIFF（200 MP超）はまだサポートされていません。最初にダウンスケールしてください。
ネットワークドライブではバッチモードが停止する可能性があります。最速の速度を得るにはローカルにコピーしてください。
GPUトグルは、DX12コンピュートキューがないマシンでは無効になります。
フラットで彩度の高い画像では、重複排除のしきい値を低くする必要がある場合があります（設定 → 詳細で調整）。

📜 ライセンスと貢献

MITライセンス – 個人、商用、教育用途で無料。帰属表示は推奨されますが必須ではありません。
リポジトリにはコンパイル済み実行ファイルとモデルファイルが含まれています。ソースコードは記載されていないため、貢献はおそらく問題の報告や新機能のリクエスト（例：ロードマップにあるLinux CLIビルド）に限定されます。

🎯 まとめ

Palette‑From‑Image‑AI は、オンデバイスビジョンモデルと知覚的カラークラスタリングを活用して、あらゆる画像から高品質でロール認識型のカラーパレットを生成する、本格的で完全オフラインのWindowsアプリケーションです。その強みは、リージョン認識抽出、豊富なエクスポートオプション、ポータブルでインストール不要のフットプリントにあり、オンラインサービスに依存せずに信頼性の高いパレットを必要とするアーティスト、UIデザイナー、ゲーム開発者にとって有用です。