Scumble

Scumble

ComfyUIと、すでにお使いのモデルに対応したAIネイティブの画像エディターです。
インペイント、編集、アップスケール、生成ができ、編集結果はそれぞれ独立したレイヤーとして戻ってきます。

⭐ GitHubでスターを付ける  ·  ダウンロード  ·  Microsoft Store

Scumbleを入手する

プラットフォーム	入手方法	備考
Windows	Microsoft Store、または winget install scumble	Microsoftによる署名済みのためSmartScreenの警告が表示されず、Storeによって更新されます
Windows	インストーラー：Scumble-Setup-<version>.exe	自動更新されます。まだコード署名されていないため、SmartScreenの確認が一度表示されます
Windows、ポータブル版	Zip：Scumble-<version>-portable-win-x64.zip	インストール不要です。データは同じフォルダー内に保存されます
Linux（x64）	AppImageまたは.deb	CIで作成された初期ビルドで、作者はまだ実行していません。問題の報告を歓迎します
macOS	まだ未対応	予定されていますが、開発は始まっていません

Scumbleは無料で使え、Scumble用のアカウントも必要ありません。詳細とレンダリングに必要なものについては、 インストールをご覧ください。

どんなことができますか？

Scumbleは、AIモデルを中心に設計されたデスクトップ画像エディターです。画像の一部を選択するか、何もない キャンバスにボックスを描いて、そこに何を配置するかを伝えると、周囲に色を合わせた結果が独立したレイヤーとして 返されます。ほかのレイヤーと同じように、マスク、ブレンド、フィルター処理、エクスポートができます。レンダリングは、 お使いのComfyUI（自分のマシン上でもリモートでも）、Comfy Cloud、またはすでにお持ちのFLUX、GPT Image、Nano Banana、Seedream などのAPIキーを通じて実行できます。APIキーだけで利用でき、ComfyUIは必要ありません。GPL-3.0のフリーソフトウェアで、 現在はWindowsで動作します。まだ開発初期（0.1.x）のため、未完成な部分があることを想定し、画像のバックアップを取ってください。

得意な5つのこと

結果はすべて独立したレイヤーになります

結果は選択範囲の上に新しいレイヤーとして配置され、縁がフェードし、周囲の画像に色が合わされます。レイヤーの行にある 「Match」スライダーで、いつでも色合わせを変更できます。また、それ以外の処理が焼き込まれることもありません。レイヤーに マスクを適用したり、一部を消去したり、ブレンドモードを変更したり、その上にフィルターやテキストを重ねたりできます。画像が 1枚になるのは、統合したときだけです。ステータス行と履歴の結果行には、どこで実行されたかが表示されます（「Comfy Router経由の FLUX 3 Image、23秒」や「お使いのComfyUI経由」など）。少し位置やサイズがずれて返ってきた結果は、画像の縁に合わせて配置されます。 また、レイヤーのメニューにある Match edges to the layer below を使うと、後から同じ調整を行えます。

配置場所を指定：ボックスと@img1

画像上にボックスを描き、それぞれについて説明します。新しく追加するもの、残すもの、移動または削除するもの、配置する参照画像、レンダリングする文字などです。Black Forest Labs の FLUX 3 Image（Scumble が実行されるすべてのプロバイダーで利用でき、お使いの ComfyUI ではオープンモデルの Klein も利用可能）は、プロンプトとともにボックスを受け取り、それぞれの要素の配置場所を指定されます。fal の Ideogram 4 は、新規、保持、テキストのボックスを受け取り、お使いの ComfyUI の MOSS-Image は、新規とテキストのボックスをもとに新しい画像をレイアウトします。参照レイヤーはプロンプト内で@img1、@img2のように指定され、それぞれは選択したモデルがその画像を認識する名前で渡されます。

お使いの ComfyUI、Comfy Cloud、または API キーだけでも

ノードグラフではなくレシピを使います。モデルと実行場所を選択できます。ローカル環境でも RunPod のようなレンタル環境でも、お使いの ComfyUI に Inpaint Canvas ノードを含むワークフローがあればレシピとして利用できます。ComfyUI ボタンを押すと、エディターの横にお使いの ComfyUI のページが開き、レシピのグラフを変更して保存できます。Comfy Cloud は Comfy の公式 SDK を通じてお使いの Comfy キーで実行され、Comfy 独自のテンプレートから作られた13種類のレシピを利用できます。同じキーで Comfy Router 上のパートナーモデルにもアクセスできます。または、Settings › API providers にキーを貼り付けてください。Black Forest Labs、OpenAI、Google、fal.ai、Replicate、OpenRouter などに対応しています。キーはシステムの認証情報ストアに保存され、設定ファイルには保存されません。

エージェントから操作できます

すべての機能がコマンドであり、コマンドは MCP サーバーです。Help › Copy MCP registration（または Claude Desktop の場合は、各リリースに含まれる.mcpbファイルをワンクリックでインストール）を使うと、Claude Code、Claude Desktop、その他の MCP クライアントから116種類のツールを利用して、同じウィンドウ内で、同じ取り消し機能を使いながら、開く、選択する、生成する、合わせる、書き出すといった操作ができます。（お使いの API キーで使えるチャットアシスタントも内蔵しています。詳しくはアシスタントをご覧ください。）

実際のファイル向けに設計

レイヤーとマスクを含む PSD 書き出し、レイヤーを含む OpenRaster 書き出しに対応し、どちらの形式もレイヤーを保持したまま再度開けます。Rust でコンパイルされたカーネルを備えたタイルエンジンにより、15,000 × 10,000 ピクセルのドキュメントでも、ウィンドウをフリーズさせずに描画、選択、書き出しができます。また、1辺が最大65,535ピクセルの PNG も開いて、分割して保存できます。フィルターも GPU 上で動作するレイヤーです。フィルム風の効果46種類、粒子、カーブ、LUT などを利用できます。

エディターのスクリーンショットに使われている写真（青い車の上の女性）は、機能を紹介するためのサンプル画像であり、Scumble で生成されたものではありません。上部と下部にあるカフェの画像は、Scumble の FLUX 3 Image で作成されました。

生成前／生成後

空のキャンバス上に描いて説明を付けた3つのボックス（左）と、Generate newを使ってそれらをもとにFLUX 3 Image が作成した画像（右）。

インストール

Windows（10 および 11、64 ビット）

• Microsoft Store： Microsoft Store の Scumble、またはターミナルで：

  winget install scumble
  

  （winget は同じ Store 版をインストールします。最初に Store の利用規約への同意を求められることがあります。）Store 版には Microsoft の署名が付いているため、SmartScreen の警告なしでインストールでき、Store が最新の状態に保ちます。新しいバージョンは Microsoft の認定後に配信されるため、GitHub でのリリースより少し遅れることがあります。Store 版は独自の設定、キー、ファイル（%APPDATA%\Scumble Store）を使用するため、GitHub 版と並べて使用できます。

• GitHub のインストーラー： 最新リリースの Scumble-Setup-<version>.exe。まだコード署名されていないため、SmartScreen に「Windows によって PC が保護されました」と一度表示されます。詳細情報をクリックしてから、実行をクリックしてください。その後、アプリが独自に更新をダウンロードし、新しいバージョンに再起動する前に確認を求めます。

• ポータブル zip： 同じリリースの Scumble-<version>-portable-win-x64.zip。C:\Tools など、書き込み可能なフォルダー（Program Files や OneDrive が同期するフォルダーは避けてください）に展開し、その中の Scumble フォルダーにある Scumble.exe を起動してください（インストーラーと同様に、SmartScreen の確認が一度表示されます）。保存されるデータはすべて同じ場所にある data フォルダーに格納されるため、インストール版の Scumble と並べて実行できます。自動更新はされません。新しいバージョンがあると通知されるので、新しい zip を古いものの上に展開してください（data フォルダーはそのまま残ります）。API キーは Windows アカウント用に暗号化されるため、別の PC では再入力が必要です（その後、最初の PC でも再入力が必要になることがあります）。

Linux

同じリリースに scumble-<version>.AppImage と scumble-<version>.deb（x64）が含まれます。**CI によってビルドされたもので、作者はまだ実行していません。報告をお待ちしています。**報告はイシューにお寄せください。詳細は以下の Linux に関する注意事項をご覧ください。

macOS

予定されていますが、まだ着手していません。

レンダリングに必要なもの

• API キーのみ： 設定 › API プロバイダー（Ctrl+,）でキーを貼り付けて、保存します。ComfyUI やサーバーは不要で、プロバイダーに直接支払います。同じキーをアシスタントとプロンプトのアップサンプリングに使用できます。

• 自分の ComfyUI： ノードパック ComfyUI-InpaintCanvas と、選択したレシピのモデルをインストールしてください。git を使って ComfyUI の custom_nodes フォルダーにパックをインストールし、その後 ComfyUI を再起動します（このパックに追加の Python パッケージは不要です）。

  cd ComfyUI/custom_nodes
  git clone https://github.com/DenRakEiw/ComfyUI-InpaintCanvas
  

  現時点で ComfyUI Manager にはこのパックが掲載されていません。掲載された後は、そこからもインストールできます。Scumble の上部バーにサーバーのアドレスを入力して、接続を押してください。接続時に Scumble がパックの有無を確認し、見つからない場合は通知しますが、自動インストールはしません。FLUX 3 Image Klein のボックスを使うには、GitHub にあるノードの最新バージョンが必要です（Comfy Registry の 0.3.4 にはまだ含まれていません）。フォルダー内で git pull を実行してクローンを更新するか、Registry からインストールしたコピーを上記のクローンに置き換えてから、ComfyUI を再起動してください。

• Comfy Cloud： 設定 › API プロバイダーに Comfy キーを入力してください。同じキーで Comfy Router を実行できます。

これらがなくても Scumble は起動し、ペイント、選択、レイヤー、フィルター、保存、エクスポートを行えます。また、アプリ内モデル（オブジェクト選択、背景の削除、削除、深度マップ）は、ダウンロード後に自分のマシン上で実行されます。

デモ：動画とマニュアル

• 動画： 全4編、2人の話し手のうち1人は懐疑派で、いずれもアプリ内で録画しています。「頼んでもいない人によるScumbleの解説」（4:40）と「Scumble、その2：質問はまだある」（4:03）はバージョン0.1.28で、「Scumble、その3：クライアントからのメモ」（5:34、0.1.42：FLUX 3 Image用のボックス、プロンプト内の参照写真）と「Scumble、その4：ショーは金曜日」（5:18、0.1.46：深度マップ、レンズぼかしと霞、27種類のブレンドモード）もあります。
• マニュアル： 最初の画像からエクスポートまでを説明します。同じテキストがアプリにも含まれています。F1キーを押すと画像の横に表示され、検索でき、オフラインでも利用できます。また、APIキーがあれば、チャットでマニュアルの内容について質問できます。ソースはdocs/MANUAL.mdです。

⭐ 気に入ったら

Scumbleが役に立った場合は、GitHubでスターを付けていただくと、ほかの人にも見つけてもらいやすくなります。問題が発生しましたか？実行した操作と起きたことを添えてissueを作成してください。Ctrl+Shift+Lでコンソールが開き、ログファイルのパスを確認できます。開発中の内容、測定した結果、うまくいかなかったことは開発ブログに掲載しています。CHANGELOG.mdにはすべてのバージョンが記載されています。

---

実環境でのテスト状況

Scumbleは0.1.xであり、すべての機能がエンドツーエンドでテストされているわけではありません。これまで実環境で実行したのは、ComfyUI経由のローカルレンダリング（FLUX 3 Image Kleinとボックス）、アプリ内ヘルパーモデル、フィルムパック、コマンドコア、MCPサーバー、大きなドキュメントでのタイルエンジン、自動アップデートです。APIプロバイダーでは、Black Forest LabsのFLUX 3 Image（ボックスあり）、OpenRouterとComfy Router（Comfy Routerでは0.1.49以降、ComfyのSDK経由でも実行）、OpenRouter経由のGPT Image 2.5、Comfy RouterのGPT Image 2とNano Banana 2、ComfyのPartner API経由のHY Image 3.5、falのIdeogram 4（ボックスあり）、Comfy CloudのQwen Image 2.1 Edit、ComfyのSDKとAPI v2経由のComfy Cloud上のZ-Image Turbo、Flux.2 Klein 9B、Nano Banana 2の編集機能（そこでキャンセルすると、Comfy側でジョブが停止しました）をテストしています。また、MagnificのアップスケーラーであるfalのTopaz Precisionと、MagnificのPrecisionおよびCreativeもテストしています。ローカルのComfyUIでは、Realism Pass（Windowsのみ、RTXのみ）とRTX Video Super Resolutionをテストしており、後者はComfy Cloudでもテスト済みです。その他のAPI接続はプロバイダーのドキュメントをもとに実装しており、まだ実サービスでは実行していません。また、Relightのモデル接続、アシスタントのモデル呼び出し、別のPCでのポータブルzip、Linuxビルドも未テストです。

機能の詳細

選択、プロンプト、生成

• ブラシ、長方形、楕円、投げ縄、マジックワンド、オブジェクトへのホバーまたはボックス（アプリ内の SAM2）、深度、明るさや色の範囲、テキスト（お使いの ComfyUI 上の SAM3）による選択に対応しています。拡張、縮小、ぼかし、反転、レイヤーからの選択、選択範囲の保存もできます。
• アプリ内（Depth Anything V2 Small、選択 › 深度）で計算され、ドキュメントとともに保存される画像の深度マップです。選択やフィルターレイヤーの範囲制限に使えるほか、レンズぼかし、かすみ、Relight にも活用できます。
• モデル：Black Forest Labs の FLUX 3 Image、FLUX.2（max、pro、flex、klein）、FLUX.1 Fill、GPT Image 2.5 Flare／Sunburst、GPT Image 2、Nano Banana 2.1、2、2 Lite、Pro、Seedream 5、4.5、Qwen Image Edit、Qwen Image 2.1、Ideogram 4、4.5、Grok Imagine、Krea 2、Recraft V4、Reve、Z-Image、HY Image 3.5、Magnific の Mystic、Ideogram のインペインティング、Image Expand のアウトペインティングに対応しています。Scumble がモデル独自の API を備えている場合はその API で、または ToAPIs、fal.ai、Replicate、WaveSpeedAI、Comfy Cloud、Comfy Router、OpenRouter、Oxen.ai、Magnific を通じて実行されます。API 実行では、プロバイダーが実際に受け付けるサイズで、お使いの参照レイヤーとともに送信されます。
• お使いの ComfyUI 上で利用できるモデル：FLUX 3 Image Klein（Black Forest Labs のオープンモデル。ComfyUI 0.41 以降が必要です。最大 3 枚の追加画像を使った選択範囲の編集、新規生成による画像の生成、ボックスの利用に対応しています。ComfyUI に Black Forest Labs のプロンプトアップサンプラーのファイルがある場合は、プロンプトを先に書き直します。その重みは Black Forest Labs 独自のライセンスで提供されます）、Flux.2 Klein 4B／9B、Qwen Image Edit 2.1 とその Turbo、MOSS-Image（ComfyUI 0.42 以降が必要です。新規生成による新しい画像の生成、ボックスからの JSON レイアウトに対応しています。Apache-2.0）。アップスケール、Realism Pass、Relight のレシピについては以下をご覧ください。
• Inpaint Canvas ノードを含むお使いのワークフローは、レシピとして利用できます。ComfyUI ウィンドウ（Ctrl+Shift+K）には、お使いの ComfyUI または Comfy Cloud のページが表示されます。ComfyUI で編集を選ぶとレシピのグラフが開き、レシピに保存または新しいレシピとして保存を選ぶと変更内容が戻されます。
• Comfy Cloud には、ローカル、APIに加えて独自のモードがあります。Comfy のテンプレートから作られた 13 種類のレシピが Scumble に付属します（画像編集と、新規生成用の新しい画像生成）。Cloud コピーを使うと、お使いの ComfyUI レシピのひとつを Comfy Cloud 上で実行できるレシピに変換できます。また、Comfy Cloud で作成したワークフローは、そのままインポートできます。Comfy Cloud と Comfy Router は、Comfy 公式の TypeScript SDK（@comfyorg/sdk）を通じて実行されます。キャンセルすると、Comfy Cloud または Comfy Router のジョブを Comfy 側で停止できます。ステータス行のバーは Cloud の実行状況をノードごとに表示します。Scumble の終了時やクラッシュ時にも実行中だった Cloud ジョブは、次回の起動時に状態を確認し、その画像を独立したドキュメントとして開きます。
• 新規生成では、プロンプトだけを使ってローカルまたはプロバイダー経由でベース画像を作成し、そこから編集できます。上部バーの新規では、モデルが対応する縦横比とサイズ区分（1k、2k、4k）で空のキャンバスを作成できます。これにより、ボックスを画像の仕上がりの形に合わせて描けます。続いて「新規生成」を選ぶと、その設定で開きます。
• FLUX 3 Image、お使いの ComfyUI 上の FLUX 3 Image Klein と MOSS-Image（Inpaint Canvas ノードの現在のバージョンが必要です。レンダリングに必要なものを参照）、fal 上の Ideogram 4 では、プロンプトでボックスを指定できます。ボックスツール（X）でボックスを描き、ダブルクリックすると画像上でそのボックスを説明できます。プロンプトの下にあるスイッチでボックスのオン／オフを切り替え、ボックスはドキュメントとともに保存されます。スイッチをオンにしてボックスを描かない場合は、選択範囲全体がひとつのボックスとして送られます。Ideogram 4 では、新規、保持、テキストのボックスを指定できます（移動、削除、参照のボックスには対応していません）。
• 保存済みの API キーまたはローカルの OpenAI 互換サーバーを通じたプロンプトのアップサンプリングに対応しています。Markdown テンプレートで独自のプロンプト作成ルールを設定できます。

レタッチ、アップスケール、調整

• クローン、修復、ぼかし、覆い焼き・焼き込み、ゆがみ、領域全体を対象にする パッチ に対応しています。削除 と コンテンツに応じた移動 は、Scumble 内で動作するモデル LaMa を使って塗りつぶします。プロンプトもキーも ComfyUI も不要です（Settings › Helpers (in-app models) から一度ダウンロードしてください）。
• オブジェクトマスク（SAM2）、背景の削除（BiRefNet、RMBG）、深度マップ（Depth Anything V2 Small）は、ONNX Runtime を通じてアプリ内で動作します。
• アップスケール は、選択範囲を処理してレイヤーとして戻すことも、画像全体を処理して新しいベース画像にすることもできます。画像全体を処理する場合は、すべてのレイヤーとマスクもまとめて拡大され、取り消し操作は1回で済みます。プロバイダー経由で Topaz、Clarity、SeedVR2、Recraft、Magnific を利用できます。また、独自の ComfyUI のアップスケールモデルや、ComfyUI または Comfy Cloud 上の RTX Video Super Resolution も1〜4倍で利用できます。RTX Video Super Resolution を独自の ComfyUI で使うには、RTX 搭載カードと、現在のバージョンで nvidia-vfx 0.2 以降を必要とするノードパック Nvidia_RTX_Nodes_ComfyUI が必要です。インストール方法は docs/RECIPES.md に記載されています。
• リアリズムパス（Windows のみ、RTX のみ） は、生成画像向けのリファイナーです。画像を独自の ComfyUI に送信し、結果を新しいレイヤーとして追加することで、生成された肌、髪、布地をより自然に見せます。1.5〜3倍では、同じ手順で画像を拡大します。Windows 上の RTX 30、40、または50シリーズ搭載カードと、そこでインストールするコミュニティノードパックおよびそのランタイムが必要です。Scumble にはこれらは含まれておらず、Comfy Cloud 版もありません。手順はマニュアルの同名の章をご覧ください。

レイヤー、フィルター、テキスト

• 完全なレイヤースタックに対応しています。ペイント、画像、テキスト、フィルターレイヤー、グループ、マスク、27種類の描画モード（乗算やスクリーンから、ハードミックス、除算、輝度まで。画面上、書き出し、PSD ファイルで同じ表示）、不透明度、変形、切り抜きと拡張（アウトペインティングの開始方法）、タブ間でのレイヤー全体のコピー＆ペースト、レイヤーとしての SVG ファイルに対応します。
• レイヤーごとの非破壊カラー調整に対応し、そのレイヤー周辺の画像、または下にある内容に合わせて色を調整できます。
• フィルターレイヤーは GPU 上で動作します（WebGL2、プロセッサーへのフォールバックあり）。フィルムプリセットを使った粒子、カーブ、レベル、カラーバランス、カラーグレーディング、8チャンネルの HSL、自然な彩度、グラデーションマップ、しきい値、ポスタライズ、LUT（.cube）、ビネット、シャープ、ぼかし、深度マップによるレンズぼかし、霞と霞の除去などを利用できます。それぞれ深度、明るさ、色の範囲を指定して適用できます。フィルムパックプラグインでは、46種類のフィルムルック、ハレーション、グロー、ブリーチバイパス、クロスプロセス、スプリットトーニング、光漏れ、フレーム、コントロールポイントを追加できます。エフェクトパックでは、色ずれとガラスの変位を追加できます。
• リライト（Layer › New Relight Layer）：深度マップを使って画像に新たなライティングを加えるフィルターレイヤーです。ライトツール（L）で最大4つのポイントライト、スポットライト、または太陽光を配置でき、それぞれに色温度または色、強度、柔らかさを設定できます。柔らかい影、光沢、スポットライト用パターン、8種類のプリセットも利用できます。Render は代わりにモデルを通じて処理し（fal 上の Magnific Relight、IC-Light v2、Bria、または ComfyUI か Comfy Cloud 上のリライト LoRA を使った Qwen Image Edit 2509）、結果をピクセルレイヤーとして追加します。エージェントは relight コマンドを使い、名前でプリセットを指定することもできます。
• シェイプツール、.abr ファイルから読み込むカスタムブラシ、独自のライトを使って画像に配置できる3Dオブジェクト（.glb）に対応しています。
• .scumble ドキュメントでは、レイヤー、フィルター、テキスト、3Dオブジェクト、プロンプト、生成結果のすべてを編集可能なまま保持できます。PNG、JPEG、WebP、TIFF、PSD、ORA への書き出しに対応し、倍率を指定するか、指定サイズのフレームに収めて書き出せます。AI label パネルでは、AI 生成コンテンツに関する EU のラベルを追加できます。

アシスタント

キャンバスの横に表示されるチャット列（Ctrl+Shift+A）で、お好みのキーを使って Anthropic、OpenAI、Google、または OpenAI 互換の エンドポイント（OpenRouter、DeepSeek、Moonshot / Kimi、Z.ai / GLM、ToAPIs、WaveSpeed、Oxen.ai、ローカルサーバー）を利用できます。MCP クライアントが受け取るものと同じコマンドを使ってエディターを操作します。料金が発生する操作、ComfyUI にジョブをキューイングする操作、元に戻す履歴を消去する操作、またはアシスタントが作成していないレイヤーに触れる操作の前には、必ず確認を求めます。Ctrl+Z で各操作を取り消せます。チャットはスクリーンショットとともに保存され、Settings › Assistant から保存した内容をすべて削除できます。プロバイダーごとにマシンから送信される情報と料金については、docs/ASSISTANT.md をご覧ください。

大きな画像、プラグイン、エージェント

• タイルエンジンは画像、すべてのレイヤー、マスクをタイル単位で保持し、ピクセルカーネルはワーカー内でコンパイル済み Rust として実行されます。ブラウザーのキャンバス上限を超える PNG（片辺最大 65,535 px、約 10 億ピクセル）も、分割して開いたり保存したりできます。
• JavaScript プラグイン（GPU とプロセッサーの両方に対応するフィルター、パネル、メニューアクション、ツール、コマンド）と、116 個のコマンドを文書化したコマンドコア（コアの 96 個と組み込みプラグインの 20 個）を備えています（docs/COMMANDS.md、docs/PLUGINS.md）。
• あらゆる MCP クライアントに対応する MCP サーバー（すべてのリリースに Claude Desktop 用の .mcpb バンドルが付属）、およびスクリプト用の --headless と --cmd を備えています（docs/MCP.md）。
• エラーを赤色で表示するステータス行と、実行ごとの状況を追跡するその横の細いバーを備えています。ComfyUI ではノードとサンプラーのステップ数、Comfy Cloud ではノード、その他のプロバイダーでは処理時間（秒）を表示します。
• セッション復元機能付きのタブ、ローカルファイルミラー（サーバーなしで作業を再び開けます）、コンソールとログファイル、再起動前にリリースノートを表示する GitHub リリースからのアップデート機能を備えています。

Linux に関する注意事項

AppImage は chmod +x を実行して起動してください。Windows アプリと同様に自動更新されます（.deb は自動更新されないため、次のバージョンを上書きインストールしてください）。Ubuntu 23.10 以降では、AppArmor による非特権ユーザー名前空間の制限のため、Electron のサンドボックス、ひいては AppImage が起動できないことがあります。.deb ではサンドボックスヘルパーが適切にインストールされます。Linux ではヘルパーモデルはプロセッサーで実行されます。API キーはデスクトップのキーリング（GNOME Keyring、KWallet）に保存されます。キーリングがない場合は、Settings › API providers にキーが難読化されるだけであることが表示されます。

はじめに

API モデルを使う場合は、Settings › API providers（Ctrl+,）にキーを入力してください。自分の ComfyUI を使う場合は、上部のバーに URL（既定値は http://127.0.0.1:8188）を入力して Connect を押してください。ComfyUI が起動していない場合、インジケーターは「No ComfyUI running」と表示したまま灰色になり、ComfyUI のレシピとテキストによる選択にのみ ComfyUI が必要です。次に、画像を開き（Ctrl+O、ドロップ、貼り付け）、選択範囲を描き、プロンプトを入力して Generate（Ctrl+Enter）を押します。Ctrl+S でドキュメントを .scumble ファイルとして保存し、Ctrl+Shift+E で画像を書き出します。すべてのドキュメントはタブで開きます（Ctrl+T で新規作成、Ctrl+W で閉じる、Ctrl+Tab で次へ）。別のタブを表示している間も処理は続行されます。Ctrl+Shift+A でアシスタントを開き、F1 でマニュアルを開きます。

エディターがアップロードまたは受信したすべての画像は、%APPDATA%/Scumble/files/（ポータブル版では Scumble.exe と同じ場所にある data/files/）の input/ および output/ フォルダーに保存されます。これらのフォルダー構成は ComfyUI のものと同じです。サーバーにはコピーだけが保存されます。処理前にアプリがサーバーにないファイルをアップロードするため、新規起動または再起動した ComfyUI（RunPod）でもドキュメントを再読み込みせずに使えます。また、サーバーに接続していなくても、次回起動時に前回のセッションが復元されます。

ソースから実行

npm install
npm start

npm run dist はインストーラー（dist/Scumble Setup <version>.exe、NSIS、署名なし）をビルドし、その後 npm run dist:portable で同じビルドからポータブル zip（dist/Scumble-<version>-portable-win-x64.zip）を作成します。リリースは GitHub Actions でビルドされます。package.json と一致するタグ v<version> を指定すると、インストーラー、そのブロックマップ、 latest.yml（自動更新フィード）、ポータブル zip、.mcpb バンドル、Linux AppImage、.deb、 latest-linux.yml を含むドラフトリリースがビルドされます。リリースノートには、そのバージョンの CHANGELOG.md のセクションが使われ、該当セクションがない場合、ビルドは停止します。 ドラフトを公開すると、アプリから見えるようになります。Rust ピクセルカーネルは renderer/editor/px/px.wasm にコミットされています。python tools/build_px.py で再ビルドできます。

テストは tools/ にあります（それぞれのテスト範囲は docs/TESTING.md を参照してください）。tools/run_gates.sh は新しいインスタンスで テスト一覧を実行します。リリースのビルド方法、承認者、アプリがネットワーク経由で送信するデータについては、 コード署名ポリシー を参照してください。開発に関するメモは CLAUDE.md を参照してください。

構成

electron/main/     main process: window, scumble:// scheme with the ComfyUI proxy, websocket, menu, dialogs, settings,
                   file mirror, keys.js (safeStorage), recipes.js, llm.js + llm_custom.js (prompt upsampling, the user's
                   own models), providers/ (one adapter per API provider), onnx/ (SAM2, matting), plugins.js,
                   updater.js (GitHub releases), bridge.js + local.js + mcp/ (agents), assistant/ (the loop, the
                   policy, the four model adapters, the chat store), comfyview.js (the ComfyUI window),
                   documents.js + docfile.js (.scumble files)
electron/preload.js
renderer/          shell.js (connection bar, recipe picker, tabs, settings), commands.js (the command core),
                   plugins.js (plugin loader and the `scumble` API), assistant.js (the chat panel)
renderer/editor/   the editor, shared with the ComfyUI node (docs/BUILD_NODE.md); host.js is the app side of it,
                   inpaint_filters_gl.js the WebGL2 filter path, stitch.js the in-app crop / stitch for provider runs,
                   inpaint_tiles.js + inpaint_arena.js + inpaint_pool.js the tile engine and its workers, px/ the Rust
                   kernels (wasm), inpaint_bands.js the strip writers
crates/px/         the Rust source of the pixel kernels
recipes/           ComfyUI recipes, Comfy Cloud recipes and model recipes (one per model, a variant per provider),
                   docs/RECIPES.md
plugins/           built-in plugins: sample, film (the film pack), effects (chromatic shift and glass),
                   glb (3D objects), ailabel (the EU AI label), boxes (boxes in the prompt), and two skins
docker/runpod/     Dockerfile + provision.sh for a ComfyUI box on RunPod (draft, docs/RUNPOD.md)
tools/             build_node.py (the node's editor), build_px.py (the kernels), cdp.py (DevTools driver), the tests,
                   run_gates.sh
docs/              MANUAL.md, BRIEF.md (vision, decisions, phases), ASSISTANT.md, COMMANDS.md, PLUGINS.md, FILM.md,
                   MCP.md, RECIPES.md, HELPERS.md, TESTING.md, CODE_SIGNING_POLICY.md and more, images/
.github/workflows/ build.yml (Windows installer, portable zip and .mcpb, Linux AppImage and .deb, draft release on a
                   version tag)

エディターは ComfyUI ノードの Inpaint Canvas と同じコードを使用しています。 ComfyUI 内で作業する場合も、同じキャンバスを利用できます。

ライセンス

Inpaint Canvas ノードおよび ComfyUI と同じ GPL-3.0 ライセンスです。LICENSE を参照してください。自由に使用、改変、 再配布できます。改変版は同じライセンスで公開する必要があります。バンドルされているフォントは OFL / Apache ライセンスです。 renderer/editor/fonts/licenses を参照してください。FLUX 3 Image Klein のレシピには、Black Forest Labs のプロンプトアップサンプラーガイド （Apache-2.0）が含まれています。recipes/licenses を参照してください。グレインプリセットおよびフィルムパック内のフィルム名は各所有者の商標です。ルックは Scumble 独自の近似表現であり、ライセンス製品ではありません。ToAPIs と WaveSpeedAI の キーを取得 リンクには、作者の紹介コードが含まれています。