ComfyUI Brightwire Tools

Brightwire Tools is a collection of ComfyUI custom nodes and workflow helpers for video/keyframe workflows.

It includes tools for:

• keyframe selection and keyframe caching
• mask batch folding and mask caching
• stable cache-key recipes
• source-video filename extraction
• safe API-key loading from environment variables or TOML secrets files
• image/mask/latent batch helpers
• subgraph input/output organization

Repository layout

comfyui_brightwire_tools/
├── custom_nodes/
│   └── ComfyUI-Brightwire-Tools/
│       ├── __init__.py
│       ├── brightwire_cache_tools/
│       ├── brightwire_keyframe_tools/
│       ├── brightwire_prompt_tools/
│       ├── brightwire_secret_tools/
│       └── ...
├── workflows/
├── docs/
├── install.py
├── install.ps1
└── pyproject.toml

Install

PowerShell:

.\install.ps1 -ComfyUIPath "C:\path\to\ComfyUI"

Python:

python install.py --comfyui "C:\path\to\ComfyUI"

Both installers copy:

custom_nodes/ComfyUI-Brightwire-Tools/

to:

<ComfyUI>/custom_nodes/ComfyUI-Brightwire-Tools/

Restart ComfyUI and hard-refresh your browser.

Manual install

Copy:

custom_nodes/ComfyUI-Brightwire-Tools/

into:

<ComfyUI>/custom_nodes/

Secrets

Do not put real API keys into workflow JSON.

Use:

<ComfyUI>/config/brightwire.secrets.toml

Example:

[ltxv]
api_key = "your-real-key-here"

The Brightwire LTXV API Key node also supports the LTXV_API_KEY environment variable.

Conditioning filename note

Brightwire Conditioning Filenames defaults its extension field to blank. This is intentional. LTXVSaveConditioning appends .safetensors itself.

Docs

The full exported node list is in Node Reference.

• Node Reference
• Secrets
• Security and Privacy
• Publishing

Crash report helper

A diagnostic helper lives at:

scripts/CrashReport.ps1

Run it from the repository or copy it wherever convenient:

.\scripts\CrashReport.ps1 -ComfyUIPath "C:\path\to\ComfyUI"

-ComfyUIPath may point either to the inner ComfyUI folder or to a portable-build parent folder that contains ComfyUI. The script writes crash bundles under _crashlogs relative to the resolved root.