ComfyUI_Scriptables Documentation

Welcome to the comprehensive documentation for ComfyUI_Scriptables, a collection of scriptable nodes for ComfyUI that execute user-provided Python scripts.

⚠️ Security Notice

All ComfyUI_Scriptables nodes use exec() to execute user-provided Python scripts. This is intentionally designed for local development and experimentation only. DO NOT use in production or expose to public networks.

Quick Navigation

Node Documentation

• ScriptableLatent - Generate latent representations
• ScriptableImage - Generate images and animations
• ScriptableMask - Generate masks
• ScriptableNoise - Generate custom noise for samplers
• ScriptableConditioning - Modify conditioning
• ScriptableEmptyLatent - Generate empty latents

Pattern Libraries

Earthbound Patterns

Inspired by EarthBound's "Video Drugs" battle backgrounds using HDMA effects.

• Overview
• HDMA Scanline Shift
• Multi-Layer Plasma
• Fractal Brownian Motion
• Earthbound Warping Distortion
• Moiré Interference
• Color Cycling Gradient
• Seamless Plasma Loop
• Rotating Fractal Loop
• Moiré Interference Loop
• Radial Breathing Loop
• HDMA Scanline Loop
• Kaleidoscope Loop

Psychedelic Patterns

Classic psychedelic visual effects for generative art.

• Overview
• Scanline Shift
• Plasma Color Cycling
• Fractal Noise Gradient

Animation Patterns

Mathematical animation techniques and visualizations.

• Overview
• Plasma Effect
• Perlin Noise Fractal
• Sine Wave Interference
• Mandelbrot Zoom
• Recursive Pattern

Mathematical Foundations

• Mathematical Foundations - Gaussian functions, Fourier transforms, complex numbers, and other mathematical concepts used in pattern generation

Getting Started

Installation

cd ComfyUI/custom_nodes
git clone http://localhost:3000/kade/ComfyUI_Scriptable.git

Configuration

# Disable scriptable nodes (security)
export COMFYUI_SCRIPTABLE_NODES_ENABLED=0

# Allow remote execution (DANGEROUS)
export COMFYUI_ALLOW_REMOTE_EXECUTION=1

Basic Usage

1. Add a ScriptableImage node to your ComfyUI workflow
2. Set width and height parameters
3. Write your Python script in the script field
4. Connect the output to other nodes

Bidirectional Syncing

Documentation in this directory syncs bidirectionally with the Forgejo wiki for kade/ComfyUI_Scriptable.

Sync script: /home/kade/reynard/wolfy/.windsurf/sync_comfyui_scriptables_wiki.py

cd /home/kade/reynard/wolfy/.windsurf
python3 sync_comfyui_scriptables_wiki.py push  # Push local to wiki
python3 sync_comfyui_scriptables_wiki.py pull  # Pull wiki to local

References

• ComfyUI_Scriptable repository: http://localhost:3000/kade/ComfyUI_Scriptable
• Wolfy workspace: /home/kade/reynard/wolfy
• Forgejo issue tracking: kade/wolfy #10