Files
Niutonian-ComfyUI-Niutonian…/.github/SETUP.md
T
Niutonian e463b2a35c Add GitHub Actions workflow and development tools
- Add automated publishing workflow using official ComfyUI publish action
- Add version bump script for easy version management
- Add comprehensive setup documentation
- Update README with development and publishing sections
2026-01-06 16:49:23 +01:00

63 lines
2.4 KiB
Markdown

# GitHub Action Setup for ComfyUI Registry Publishing
This repository includes a GitHub Action that automatically publishes your custom node to the ComfyUI Registry whenever the `pyproject.toml` file is updated, using the official ComfyUI publish action.
## Setup Instructions
### 1. Add GitHub Repository Secret (REQUIRED)
1. Go to your GitHub repository: https://github.com/Niutonian/ComfyUI-Niutonian-Themes
2. Click on **Settings** tab
3. In the left sidebar, click **Secrets and variables** → **Actions**
4. Click **New repository secret**
5. Name: `REGISTRY_ACCESS_TOKEN`
6. Value: `184be226-a615-41ab-aac5-ebdb37911cb7`
7. Click **Add secret**
### 2. Verify Branch Configuration
The workflow is configured for the `main` branch, which matches your current setup.
### 3. Test the Publishing
To publish a new version:
1. Update the `version` field in `pyproject.toml` (currently 1.2.0)
2. Commit and push the changes to your main branch
3. The GitHub Action will automatically trigger and publish the new version
4. You can also trigger it manually from the Actions tab using "workflow_dispatch"
## How It Works
The action triggers when:
- A push is made to the main branch AND the `pyproject.toml` file is modified
- You manually trigger it from the Actions tab
The workflow uses the official `Comfy-Org/publish-node-action@main` which:
1. Reads your `pyproject.toml` configuration
2. Validates the custom node structure
3. Publishes to the ComfyUI Registry using your API token
4. Makes it available in ComfyUI Manager
## Current Configuration
- **Package Name**: comfyui-niutonian-themes
- **Current Version**: 1.2.0
- **Publisher**: @Niutonian
- **Repository**: https://github.com/Niutonian/ComfyUI-Niutonian-Themes
- **Registry URL**: https://registry.comfy.org/publishers/Niutonian/nodes/comfyui-niutonian-themes
## Troubleshooting
- **Action fails**: Check the Actions tab in your GitHub repository for error logs
- **Authentication issues**: Verify your `REGISTRY_ACCESS_TOKEN` secret is correctly set
- **Version conflicts**: Make sure you're incrementing the version number in `pyproject.toml`
- **Metadata issues**: Ensure your `pyproject.toml` has all required ComfyUI fields
## Manual Publishing Alternative
You can also publish manually using the ComfyUI CLI:
```bash
# Install comfy-cli if not already installed
pip install comfy-cli
# Publish manually
comfy node publish
# Enter your API key when prompted: 184be226-a615-41ab-aac5-ebdb37911cb7
```