ノードの公開

レジストリアカウントの設定

以下の手順に従って、レジストリアカウントを設定し、最初のノードを公開してください。

チュートリアルを見る

パブリッシャーの作成

パブリッシャーは、レジストリにカスタムノードを公開できる識別情報です。すべてのカスタムノードには、pyproject.toml ファイルにパブリッシャー識別子を含める必要があります。 Comfy Registry にアクセスし、パブリッシャーアカウントを作成してください。パブリッシャー ID はグローバルに一意であり、後から変更することはできません。これはカスタムノードの URL に使用されるためです。パブリッシャー ID は、プロフィールページの @ 記号の後ろにあります。

レジストリ公開用 API キーの作成

重要: この API キーは、カスタムノードをレジストリおよび ComfyUI-Manager に公開するためのものです。ワークフローで有料の API ノードを使用したい場合は、API ノードの概要を参照してください。

こちらにアクセスし、API キーを作成したいパブリッシャーをクリックしてください。このキーは、CLI または GitHub Actions を介してカスタムノードをレジストリ（ComfyUI-Manager を動かすもの）に公開するために使用されます。

API キーに名前を付け、安全な場所に保存してください。紛失した場合、新しいキーを作成する必要があります。

メタデータの追加

comfy-cli はインストール済みですか？まずはこちらを実行してください。

comfy node init

このコマンドは、以下のメタデータを生成します：

# pyproject.toml
[project]
name = "" # Unique identifier for your node. Immutable after creation.
description = ""
version = "1.0.0" # Custom Node version. Must be semantically versioned.
license = { file = "LICENSE.txt" }
dependencies  = [] # Filled in from requirements.txt

[project.urls]
Repository = "https://github.com/..."

[tool.comfy]
PublisherId = "" # TODO (fill in Publisher ID from Comfy Registry Website).
DisplayName = "" # Display name for the Custom Node. Can be changed later.
Icon = "https://example.com/icon.png" # SVG, PNG, JPG or GIF (MAX. 800x400px)

このファイルをリポジトリに追加してください。pyproject.toml ファイルの詳細については、仕様を確認してください。

`.comfyignore` でファイルを除外する

デフォルトでは、comfy node publish は git で追跡されているすべてのファイルをパッケージ化します。開発専用のファイル（テスト、デザインアセット、大きなサンプルなど）を公開アーカイブから除外するには、リポジトリのルートに .comfyignore ファイルを追加してください。構文は .gitignore と同じです：

# 開発専用のアセット
docs/
tests/
*.psd
.vscode/

.comfyignore は .gitignore の上に重ねて適用されます — git で追跡されていないファイルはすでに除外されています。git に 残しておきたい が、レジストリアーカイブには含めたくないファイルを除外するために .comfyignore を使用してください。
[tool.comfy].includes に列挙されたディレクトリは、.comfyignore のパターンに一致しても強制的に含まれます（ビルドされた dist/ フォルダーが .gitignore で無視されていても配布する必要がある場合などに便利です）。
ローカル実行と CI が同じアーカイブを生成するように、.comfyignore をリポジトリにコミットしてください。

レジストリへの公開

オプション 1: Comfy CLI

以下のコマンドを実行して、ノードを手動でレジストリに公開します。

comfy node publish

API キーの入力を求められます。

API Key for publisher '<publisher id>': ****************************************************

...Version 1.0.0 Published. 
See it here: https://registry.comfy.org/publisherId/your-node

API キーはデフォルトで非表示であることを覚えておいてください。

コピーペースト時、CTRL+V (Windows) を使用すると、末尾に余分な \x16 が付くことがあります。例：************************************************\x16。API キーは右クリックしてコピーペーストすることをお勧めします。

オプション 2: Github Actions

Github Actions を使用してノードを自動公開します。

Github Secret の設定

Settings -> Secrets and Variables -> Actions -> Under Secrets Tab and Repository secrets -> New Repository Secret に移動します。REGISTRY_ACCESS_TOKEN という名前のシークレットを作成し、値として API キーを保存します。

Github Action の作成

以下のコードをコピーし、/.github/workflows/publish_action.yml に貼り付けます。

name: Publish to Comfy registry
on:
  workflow_dispatch:
  push:
    branches:
      - main
    paths:
      - "pyproject.toml"

jobs:
  publish-node:
    name: Publish Custom Node to registry
    runs-on: ubuntu-latest
    steps:
      - name: Check out code
        uses: actions/checkout@v4
      - name: Publish Custom Node
        uses: Comfy-Org/publish-node-action@main
        with:
          personal_access_token: ${{ secrets.REGISTRY_ACCESS_TOKEN }} ## Add your own personal access token to your Github Repository secrets and reference it here.

作業ブランチの名前が main 以外の場合（例：master）、branches セクションに名前を追加してください。

Github Action のテスト

pyproject.toml のバージョン番号を更新してプッシュしてください。レジストリに更新されたノードが表示されるはずです。

Github Action は、pyproject.toml ファイルを更新してプッシュするたびに自動実行されます。

ComfyUI APIs

CLI

カスタムノード開発

レジストリ（Registry）

仕様

ノードの公開

レジストリアカウントの設定

チュートリアルを見る

パブリッシャーの作成

レジストリ公開用 API キーの作成

メタデータの追加

`.comfyignore` でファイルを除外する

レジストリへの公開

オプション 1: Comfy CLI

オプション 2: Github Actions

​レジストリアカウントの設定

​チュートリアルを見る

​パブリッシャーの作成

​レジストリ公開用 API キーの作成

​メタデータの追加

​.comfyignore でファイルを除外する

​レジストリへの公開

​オプション 1: Comfy CLI

​オプション 2: Github Actions

レジストリアカウントの設定

チュートリアルを見る

パブリッシャーの作成

レジストリ公開用 API キーの作成

メタデータの追加

`.comfyignore` でファイルを除外する

レジストリへの公開

オプション 1: Comfy CLI

オプション 2: Github Actions