ComfyUI-KikoTools

A modular collection of essential custom ComfyUI nodes missing from the standard release.

ComfyUI-KikoTools provides carefully crafted, production-ready nodes grouped under the "ComfyAssets" category. Each tool is designed with clean interfaces, comprehensive testing, and optimized performance for SDXL and FLUX workflows.

🚀 Features

✨ Current Tools

📐 Resolution Calculator

Calculate upscaled dimensions from image or latent inputs with precision.

• Smart Input Handling: Works with both IMAGE and LATENT tensors
• Model Optimized: Specific optimizations for SDXL (~1MP) and FLUX (0.2-2MP) models
• Constraint Enforcement: Automatically ensures dimensions divisible by 8
• Flexible Scaling: Supports scale factors from 1.0x to 8.0x with 0.1 precision
• Aspect Ratio Preservation: Maintains original proportions during scaling

Use Cases:

• Calculate target dimensions for upscaler nodes
• Plan memory usage for large generations
• Ensure ComfyUI tensor compatibility
• Optimize batch processing workflows

🔧 Architecture Highlights

• Modular Design: Each tool is self-contained and independently testable
• Test-Driven Development: 100% test coverage with comprehensive unit tests
• Clean Interfaces: Standardized input/output patterns across all tools
• Separation of Concerns: Clear distinction between logic, UI, and integration layers
• SOLID Principles: Extensible architecture following software engineering best practices

📦 Installation

ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "ComfyUI-KikoTools"
3. Click Install
4. Restart ComfyUI

Manual Installation

cd ComfyUI/custom_nodes/
git clone https://github.com/ComfyAssets/ComfyUI-KikoTools.git
cd ComfyUI-KikoTools
pip install -r requirements-dev.txt

Restart ComfyUI and look for ComfyAssets nodes in the node browser.

🎯 Quick Start

Resolution Calculator Example

Image Loader → Resolution Calculator → Upscaler
             ↘ scale_factor: 1.5    ↗

Input: 832×1216 (SDXL portrait format)
Scale: 1.5x
Output: 1248×1824 (ready for upscaling)

Common Workflows

SDXL Portrait Upscaling

{
  "workflow": "Load SDXL portrait → Calculate 1.5x dimensions → Feed to upscaler",
  "input_resolution": "832×1216", 
  "scale_factor": 1.5,
  "output_resolution": "1248×1824",
  "memory_efficient": true
}

FLUX Batch Processing

{
  "workflow": "Generate latents → Calculate target size → Batch upscale",
  "input_resolution": "1024×1024",
  "scale_factor": 2.0, 
  "output_resolution": "2048×2048",
  "batch_optimized": true
}

📚 Documentation

Available Tools

Tool	Description	Status	Documentation
Resolution Calculator	Calculate upscaled dimensions with model optimization	✅ Complete	Docs
Batch Image Processor	Process multiple images with consistent settings	🚧 Planned	Coming Soon
Advanced Prompt Utilities	Enhanced prompt manipulation and generation	🚧 Planned	Coming Soon
Model Management Tools	Efficient model loading and memory management	🚧 Planned	Coming Soon

Technical Specifications

Resolution Calculator

Inputs:

• scale_factor (FLOAT): 1.0-8.0, default 2.0
• image (IMAGE, optional): Input image tensor
• latent (LATENT, optional): Input latent tensor

Outputs:

• width (INT): Calculated target width
• height (INT): Calculated target height

Constraints:

• All outputs divisible by 8 (ComfyUI requirement)
• Preserves aspect ratio
• Validates input tensors
• Graceful error handling

🛠️ Development

Prerequisites

• Python 3.8+
• ComfyUI installation
• PyTorch 2.0+

Development Setup

# Clone the repository
git clone https://github.com/ComfyAssets/ComfyUI-KikoTools.git
cd ComfyUI-KikoTools

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
python -c "
import sys, os
sys.path.insert(0, os.getcwd())
from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode
import torch

# Quick test
node = ResolutionCalculatorNode()
result = node.calculate_resolution(2.0, image=torch.randn(1, 512, 512, 3))
print(f'✅ Development setup successful! Test result: {result[0]}x{result[1]}')
"

Code Quality

We maintain high code quality standards:

# Format code
black .

# Lint code  
flake8 .

# Type checking
mypy .

# Run all quality checks
make quality-check  # If Makefile exists

Testing Philosophy

Following Test-Driven Development (TDD):

1. Write Tests First: Define expected behavior before implementation
2. Red-Green-Refactor: Fail → Pass → Improve cycle
3. Comprehensive Coverage: Unit, integration, and scenario testing
4. Real-World Validation: Test with actual ComfyUI workflows

# Test structure
tests/
├── unit/                    # Individual component tests
├── integration/            # ComfyUI workflow tests  
└── fixtures/              # Test data and workflows

Adding New Tools

1. Plan: Define tool purpose, inputs, outputs in plan.md
2. Test: Write comprehensive tests following TDD
3. Implement: Build tool logic with proper validation
4. Integrate: Create ComfyUI node interface
5. Document: Add usage examples and workflows
6. Validate: Test in real ComfyUI environment

See our Contributing Guide for detailed instructions.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Principles

• KISS: Keep It Simple, Stupid
• Separation of Concerns: Clear module boundaries
• DRY: Don't Repeat Yourself
• SOLID: Object-oriented design principles
• TDD: Test-driven development

Reporting Issues

Please use GitHub Issues with:

• ComfyUI version
• Tool/node name
• Expected vs actual behavior
• Minimal reproduction steps
• Error logs if applicable

📄 License

MIT License - see LICENSE file for details.

🏷️ Tags

comfyui custom-nodes image-processing ai-tools sdxl flux upscaling resolution batch-processing python pytorch

🔗 Links

• ComfyUI: https://github.com/comfyanonymous/ComfyUI
• Documentation: examples/documentation/
• Example Workflows: examples/workflows/
• Issue Tracker: GitHub Issues

📈 Stats

• Nodes: 1 (Resolution Calculator)
• Test Coverage: 100%
• Python Version: 3.8+
• ComfyUI Compatibility: Latest
• Dependencies: Minimal (PyTorch, NumPy)

---

Made with ❤️ for the ComfyUI community

⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature