ComfyUI_Detonate: Instructions file for Claude Code

Guide for Claude - ComfyUI_Detonate Project

This document provides context for future Claude sessions working on this project.

---

Project Summary

ComfyUI_Detonate is a custom node package for ComfyUI that brings professional compositing tools from Nuke and DaVinci Fusion to the ComfyUI platform. The goal is to provide VFX compositors with familiar, industry-standard nodes for traditional compositing workflows alongside AI image generation.

---

Key Project Documents

Primary References

1. PLANNING.md - Complete project vision, architecture, and roadmap
2. TASKS.md - Detailed task checklist for implementation
3. DOCS/NODE_PRIORITIES.md - 43 nodes prioritized by importance

Quick Reference

• Language: Python 3.8+
• Framework: ComfyUI Custom Node API
• Core Libraries: PyTorch, NumPy, Pillow
• Target: Professional compositors and VFX artists

---

Project Status

Current Phase: Phase 1 - Planning Complete ✓

Completed:

• Project vision and goals defined
• Architecture designed
• Technology stack selected
• 43 nodes researched and prioritized
• Development roadmap created

Next Steps:

1. Create directory structure
2. Set up pyproject.toml and requirements.txt
3. Implement utility modules (tensor_utils.py, image_processing.py, color_math.py)
4. Create __init__.py with node registration system
5. Begin implementing Priority 1 nodes (Merge, Transform, Blur, Grade, Premult/Unpremult)

---

Technical Architecture

Directory Structure

ComfyUI_Detonate/
├── __init__.py                 # Node registration
├── nodes/                      # Node implementations
│   ├── compositing/            # Merge operations
│   ├── color/                  # Color correction
│   ├── keying/                 # Keying tools
│   ├── transform/              # Transforms
│   ├── filter/                 # Blur, sharpen, etc.
│   ├── matte/                  # Matte operations
│   ├── channel/                # Channel ops
│   ├── time/                   # Time operations
│   └── 3d/                     # 3D compositing
├── utils/                      # Shared utilities
│   ├── tensor_utils.py
│   ├── image_processing.py
│   └── color_math.py
├── tests/                      # Unit tests
├── examples/                   # Example workflows
├── web/js/                     # Frontend extensions
├── pyproject.toml              # Package metadata
├── requirements.txt            # Dependencies
└── README.md                   # Documentation