- Add sample_workflow.json with complete Z-Image Turbo workflow
- Includes SID_LLM_Local, SID_LLM_API, and SID_ZImagePromptGenerator
- Link to download from README
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- README now focused on quick start and basic usage
- Technical_Details.md contains provider configs, settings, migration guide
- Link to Technical_Details.md for advanced users
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add full workflow screenshot as main header image
- Reorganize nodes section into table with screenshots and descriptions
- Each node now shows: name, screenshot, and detailed description
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Phi-3.5 Vision marked as fastest local model
- Updated recommendation to note QwenVL for quality, Phi for speed
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
QwenVL currently produces the best quality prompts among local models.
Updated table and added recommendation note.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add documentation that local models perform better with reasoning disabled
(single-shot mode) since they struggle with structured JSON output required
for agentic analysis.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add detailed setup for each provider (Anthropic, OpenAI, Grok, Together AI, LM Studio, Ollama, GGUF)
- Include specific settings and values for each provider
- Restore workflow screenshot image reference
- Add changelog section
- Document all node settings with descriptions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Detect GPU type: NVIDIA CUDA, Apple Silicon Metal, AMD ROCm, CPU
- Auto-install correct llama-cpp-python wheel/build
- Support Windows, Linux, and macOS
- Update welcome message to show GPU type
- Update README to reflect auto-installation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Complete README rewrite for new Z-Image node
- Document multi-provider support (Anthropic, Ollama, Grok)
- Add Ollama VRAM tier guide
- Add Z-Image best practices section
- Update troubleshooting for all providers
- Add openai and requests to requirements.txt
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
FIXES:
1. Color Style Not Applied (CRITICAL BUG FIX)
- Completely rewrote color style enforcement mechanism
- Added explicit comma-separated term mappings for each color style
- Implemented ⚠️ CRITICAL warnings with MANDATORY requirements
- Added contradictory term exclusions (B&W forbids "color", Color forbids "monochrome")
- Color terms now MUST appear first in prompt sequence
- Example: "Black and White" → "black and white photography, monochrome, grayscale, B&W, no color"
2. Model Input Connection Support
- Added force_input=False to target_model parameter
- Can now connect model name from model loader nodes
- Maintains ability to type model name manually
- Updated tooltip to clarify dual functionality
3. Enhanced Model Detection Patterns
- SDXL: +9 patterns (pony, animagine, realvis xl, zavychroma, duchaiten, dreamshaper xl, crystal clear, hellonijicute, counterfeit xl)
- SD 1.5: +7 patterns (deliberate, epicrealism, cyberrealistic, majicmix, chilloutmix, revanimated, absolutereality, analog madness, perfect world)
- More comprehensive automatic model type detection
CLARIFICATIONS:
- Model Research Methodology
* Updated docstring to clarify using pattern matching (not live web search)
* Added note about future CivitAI/HuggingFace API integration
* Changed research_source from "inference" to "pattern_matching"
* Explained that real-time API calls require external dependencies
Technical Details:
- Color style system now provides exact comma-separated terms to use
- Enforcement changed from "include as PRIMARY term" to "Start with EXACT terms: X, Y, Z"
- Added explicit prohibition against contradictory terms
- Model detection now covers 30+ popular model names across all types
Why These Fixes:
User reported color style (B&W) not being applied even when selected. Root cause was insufficient enforcement in system prompt. New approach uses explicit term lists and critical warnings to Claude, ensuring compliance.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
MAJOR UPDATE: Transformed into an intelligent prompting agent that automatically researches models and provides tailored recommendations.
🚀 NEW FEATURES:
- Intelligent Model Research Agent
* Automatically detects model type from name (FLUX/SDXL/SD 1.5)
* Infers model characteristics and capabilities
* Prepared for CivitAI and HuggingFace MCP integration
* Tailors all prompt generation based on research
- Sampler Configuration Output (3rd output)
* Auto-generates optimal sampler settings per model
* Markdown-formatted with pretty tables
* Includes: sampler, steps, CFG scale, clip_skip, etc.
* Model-specific guidance and recommendations
- Dynamic Model Input
* Changed from dropdown to text input
* Accepts ANY model name (FLUX.1-dev, juggernaut_reborn, etc.)
* Agent intelligently adapts to any model
BREAKING CHANGES:
- Output names simplified:
* positive_prompt → positive
* negative_prompt → negative
* NEW: sampler_config (3rd output)
- Target model parameter:
* Was: Dropdown (FLUX, SDXL, SD 1.5, Universal)
* Now: Text input accepting any model name
* Agent automatically detects and optimizes
Implementation Details:
- New _research_model() function (lines 305-428)
* Pattern matching for model type detection
* Returns comprehensive model_info dict
* Includes characteristics, token limits, sampler settings
- New _generate_sampler_config() function (lines 781-826)
* Generates markdown with settings table
* Provides model-specific guidance
* Pretty formatting for easy reading
- Updated _build_system_prompt()
* Now receives model_info dict instead of string
* Incorporates model characteristics into prompts
* Adjusts token limits based on detected type
- Enhanced Console Logging
* Shows complete model research results
* Displays detected type, base model, characteristics
* Outputs sampler configuration recommendations
Why This Update:
Users need prompts optimized for their SPECIFIC model, not just generic types. This intelligent agent researches the actual model being used and tailors everything accordingly. The sampler config output provides actionable recommendations that can be immediately applied in ComfyUI workflows.
Ready for Future Enhancement:
- MCP integration points prepared for CivitAI search
- MCP integration points prepared for HuggingFace search
- Can be enhanced with live API lookups when MCPs configured
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
BREAKING CHANGE: Complete rewrite of prompt generation system to output clean comma-separated prompts instead of markdown-formatted text. This addresses the core issue where markdown formatting doesn't work with image generation models.
Key Changes:
- Comma-separated single-line output format (no markdown, no sections)
- Token limit management per model based on research:
* FLUX: 200-256 optimal (max 512), concise negatives (30-50)
* SDXL: 27-75 optimal (max 75), moderate negatives (40-60)
* SD 1.5: 50-75 optimal (max 75), comprehensive negatives (75-100)
* Universal: 100-120 optimal, balanced negatives (50-70)
- Priority-based prompt sequencing:
* Priority 1: Style requirements (color, photographer, lighting)
* Priority 2: Subject description
* Priority 3: Technical details
* Priority 4: Quality terms
- Streamlined system prompts (850 lines → 653 lines)
- Model-specific negative prompt strategies
- User instructions and style requirements now appear FIRST in prompts
Technical Implementation:
- Rewrote _build_system_prompt() function completely
- Added explicit token limit guidance to Claude
- Implemented priority sequencing system
- Maintained all existing parameters and features
- Preserved photographer and lighting descriptions
- Enhanced model-specific optimization instructions
Why This Update:
Previous versions generated markdown-formatted prompts with section headers and bullet points. These don't work properly with FLUX/SDXL/SD 1.5 models which expect comma-separated keyword lists. This major rewrite ensures proper prompt format and token length for each model type.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed issue where seed parameter was not rendering correctly as a proper integer input with randomization controls. Added control_after_generate=True parameter which enables the standard ComfyUI seed widget with increment/decrement/randomize buttons. Also cleared Python cache to ensure clean node definition loading.
Changes:
- Added control_after_generate=True to seed Int.Input
- Cleared __pycache__ directory for clean reload
- Updated version to 1.3.4
- Added changelog entry for bugfix
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed validation error that occurred when loading workflows saved before seed, lighting_condition, color_style, and photographer_style parameters were added. Added None value handling in execute function to provide safe defaults when these parameters are missing from older workflows.
Changes:
- Added None checks for seed (defaults to 0), lighting_condition, color_style, and photographer_style (default to "None")
- Updated version to 1.3.3
- Added changelog entry for bugfix
- Ensures old workflows continue to work seamlessly
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed issue where seed parameter was showing "nan" in the ComfyUI interface. Changed the max value from 0xffffffffffffffff (64-bit max) to 2147483647 (standard 32-bit signed int max), which is the standard approach used in ComfyUI nodes.
Changes:
- Updated seed max value to 2147483647
- Updated version to 1.3.2
- Added changelog entry for bugfix
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive lighting_condition dropdown with 31 options across 4 categories (Studio Lighting, Studio Techniques, Outdoor/Natural, Special/Creative). Each lighting type includes detailed characteristics for light source, quality, direction, color temperature, shadows, and mood. Updated system prompts to incorporate lighting conditions into positive prompt generation.
Changes:
- Added lighting_condition parameter with 31 lighting options
- Updated execute function signature and system prompt builder
- Created lighting_descriptions dictionary with detailed specs
- Updated docstring and version to 1.3.1
- Updated README with lighting condition documentation
- Added changelog entry for v1.3.1
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
NEW FEATURES:
- Color Style dropdown with 9 options (None, B&W, Color, Monochrome, Sepia, Cross-Processed, High Contrast B&W, Low Key, High Key)
- Photographer Style dropdown with 20 famous photographers (Helmut Newton, Peter Lindbergh, Annie Leibovitz, Richard Avedon, Irving Penn, Herb Ritts, Mario Testino, Steven Meisel, Patrick Demarchelier, Paolo Roversi, Tim Walker, Ellen von Unwerth, David LaChapelle, Steven Klein, Mert and Marcus, Juergen Teller, Bruce Weber, Terry Richardson, Rankin, Albert Watson)
- Seed parameter for randomization (standard ComfyUI seed system)
IMPROVEMENTS:
- System prompts now incorporate color style requirements
- Each photographer has detailed style descriptions (lighting, composition, post-processing)
- Enhanced console logging (shows color style, photographer style, seed)
- All new features have "None" options for backward compatibility
FILES CHANGED:
- sid_ai_prompt_generator.py: +109 lines (new parameters, photographer descriptions, color style logic)
- __init__.py: Version bump to 1.3.0
- README.md: +35 lines (new features documentation, updated changelog)
Author: Siddhartha Lahiri
🤖 Generated with Claude Code
