ComfyUI-Doctor Introduction
ComfyUI-Doctor is a real-time diagnostic extension designed specifically for ComfyUI. It automatically intercepts all terminal outputs from the moment it starts, capturing complete Python tracebacks and providing prioritized repair suggestions through node-level context extraction. With over 57 error patterns (22 built-in and 35 community-contributed), it offers a robust error detection and management system. The extension supports JSON hot-reload mode, allowing users to manage additional error types easily. It is available in 9 languages and features log persistence and a RESTful API for seamless front-end integration.
How ComfyUI-Doctor Works
ComfyUI-Doctor operates by continuously monitoring the terminal outputs of ComfyUI. When an error occurs, it captures the traceback and analyzes it using a set of predefined error patterns. These patterns help identify the type of error and provide suggestions for fixing it. The extension extracts context at the node level, identifying the node where the error occurred, and includes system environment details like Python version and installed packages to enhance the accuracy of its analysis. This process is akin to having a vigilant assistant that not only spots issues but also suggests solutions, making it easier for you to maintain a smooth workflow.
ComfyUI-Doctor Features
- Automatic Error Monitoring: Instantly intercepts all terminal outputs and detects Python tracebacks.
- Intelligent Error Analysis: Offers actionable repair suggestions based on 57+ error patterns.
- Node Context Extraction: Automatically identifies the node where the error occurred, providing details like node ID, name, and category.
- System Environment Context: Includes Python version, installed packages, and OS information in the analysis.
- Multilingual Support: Available in 9 languages, ensuring accessibility for a global audience.
- JSON Pattern Management: Supports hot-reloading of error patterns without restarting ComfyUI.
- Community Pattern Support: Covers popular extensions like ControlNet, LoRA, VAE, and more.
- Debug Nodes: Allows in-depth inspection of data flow within workflows.
- Error History Logging: Retains a buffer of recent errors for review.
- RESTful API: Provides endpoints for front-end integration.
- AI-Powered Analysis: Integrates with multiple AI providers for advanced error analysis.
- Interactive Sidebar Interface: Visual error panel for real-time diagnostics and node localization.
- Flexible Configuration: Comprehensive settings panel for customizing behavior.
🆕 AI Chat Interface
The new interactive chat interface offers a conversational debugging experience directly integrated into ComfyUI's sidebar. When an error occurs, you can click "Analyze with AI" to start a multi-turn conversation with your preferred language model.
Key Features:
- Context Awareness: Automatically includes error details, node information, and workflow context.
- Environment Awareness: Enhances debugging accuracy by including Python version, installed packages, and OS information.
- Streaming Responses: Displays LLM responses in real-time with proper formatting.
- Multi-turn Conversations: Allows follow-up questions for deeper exploration of issues.
- Always Visible: Input area remains fixed at the bottom for easy access.
- Supports 8+ LLM Providers: Including OpenAI, DeepSeek, Groq, Gemini, Ollama, LMStudio, and more.
- Smart Caching: Caches package lists for 24 hours to avoid performance impact.
ComfyUI-Doctor Models
ComfyUI-Doctor does not have different models in the traditional sense but supports various error patterns and AI providers for analysis. The extension can be configured to use different language models from providers like OpenAI, DeepSeek, and others, depending on your needs and preferences.
What's New with ComfyUI-Doctor
Latest Updates (January 2026)
- F4: Statistics Dashboard: Provides insights into error trends, common issues, and resolution progress.
- T8: Pattern Validation CI: Ensures zero-defect contributions with automated quality checks for error patterns.
- Phase 4B: Pattern System Upgrade: Major architectural upgrade with 57+ error patterns and JSON hot-reload management.
Previous Updates (December 2025)
- F9: Multilingual Support Expansion: Language support expanded from 4 to 9 languages.
- F8: Sidebar Settings Integration: Simplified settings accessible directly from the sidebar.
Troubleshooting ComfyUI-Doctor
Common Issues and Solutions
- Error Notifications Not Displaying: Ensure that the "Show error notifications" setting is enabled in the settings panel.
- AI Analysis Not Working: Verify that your API key is correctly entered and that the AI provider's base URL is accessible.
- Errors Not Being Captured: Check that ComfyUI-Doctor is enabled and that the log interception system is active.
Frequently Asked Questions
- How do I change the language?: Use the settings panel in the sidebar to select your preferred language.
- Can I add custom error patterns?: Yes, you can manage additional error patterns using the JSON hot-reload feature.
Learn More about ComfyUI-Doctor
For more information, tutorials, and community support, consider exploring the following resources:
- ComfyUI-Doctor GitHub Repository
- ComfyUI Community Forums
- AI Studio by Google for free API access to Gemini models. These resources provide valuable insights and support for AI artists looking to enhance their workflow with ComfyUI-Doctor.