ComfyUI-SimpleChat

Simple, no-nonsense LLM chat nodes for ComfyUI. Connect to OpenAI, Claude, Gemini, and local LLMs with ease.

English | 中文

View Example Workflow JSON

Features

• All-in-One Configuration: Single, powerful config node for all providers.
• Dynamic Model Fetching: Click one button to fetch the actual list of models available to your API key. No hardcoded lists!
• Universal Compatibility: Works with official APIs and any OpenAI-compatible proxy/local endpoint.
• Multimodal Support: Chat with images using vision-capable models.
• NoASS Roleplay Mode (Exp): Experimental Hardcore roleplay node with Assistant Prefill support.
• Gemini Native Features: Dedicated nodes for Gemini's image generation and editing capabilities.

Installation

1. Clone this repository into your ComfyUI/custom_nodes folder:

git clone https://github.com/Moeblack/ComfyUI-SimpleChat.git

2. Restart ComfyUI.

Usage Guide

1. API Configuration (The Core)

Everything starts with the API Config node.

1. Add Node: Right-click -> SimpleChat -> API Config.
2. Select Provider: Choose openai, claude, or gemini.
3. Enter API Key: Paste your secret key.
   • OpenAI: sk-...
   • Claude: sk-ant-...
   • Gemini: Your Google AI Studio key.
4. Base URL (Optional):
   • Strongly recommended to leave empty unless you are using a proxy or local model.
   • The plugin has built-in default official API addresses:
     • OpenAI: https://api.openai.com/v1
     • Claude: https://api.anthropic.com/v1
     • Gemini: https://generativelanguage.googleapis.com/v1beta
   • If you use a proxy service (like DeepSeek, OneAPI, etc.), you usually need to fill in the full path including /v1, e.g., https://api.deepseek.com/v1.
5. Select Model:
   • Click the "Refresh Models" button.
   • The node will connect to the API and fetch the real-time list of models you can use.
   • Select your desired model from the dropdown.

2. Basic Chat

Use this for standard text generation or Q&A.

• Node: Chat
• Connection: Connect config from API Config to config on Chat.
• Input: Enter your prompt in text.
• Output: Returns the AI's response as a string.

3. Chat with Images

Use this to have the AI analyze or describe an image.

• Node: Chat with Image
• Connection:
  • Connect config from API Config.
  • Connect an image (from Load Image node) to the image input.
• Input: Enter a prompt (e.g., "Describe this image").

4. NoASS Chat (Experimental)

The "No Assistant" (NoASS) node is an experimental feature designed for hardcore roleplay and creative writing. It forces the AI to break character restrictions by pre-filling its response start.

• Node: Chat NoASS (Exp)
• Inputs:
  • Scenario Instructions: (User Message) Define the world, characters, and rules. This sets the stage.
  • User Action: Your current turn or dialogue.
  • Prefill Start (Optional): Force the first few words of the AI's response. The AI must continue from here. Great for steering the tone.
  • History: Connect output history to the next node's input history to maintain conversation context.

5. Gemini Image Generation

Generate images using Google's Gemini models.

• Node: Gemini Image Gen
• Requirement: Must use gemini provider in API Config.
• Output: Generates a standard ComfyUI IMAGE.

6. Gemini Image Editing

Modify existing images using text instructions.

• Node: Gemini Image Edit
• Input: Source image + Mask image + Prompt.

FAQ

Q: I don't see my model in the list. A: Make sure you entered your API Key and Base URL correctly, then click Refresh Models. If the API supports listing models, they will appear. If not, you can try typing the model name directly (if the UI allows) or checking your provider's documentation.

Q: Can I use local models? A: Yes! Select openai as the provider, set the Base URL to your local server address (e.g., http://127.0.0.1:1234/v1), and click Refresh.

Q: My dropdown is empty. A: Check your internet connection and API Key. If the API Key is invalid, the list will not populate.

License

MIT