https://github.com/lord-lethris/comfyui-rpg-characters
Stylized RPG character prompt generator for ComfyUI. Supports SD, SDXL, Flux, and Ollama-driven prompts.
https://github.com/lord-lethris/comfyui-rpg-characters
ai-art character-generator comfyui comfyui-custom-node comfyui-nodes custom-nodes fantasy-characters flux ollama prompt-generator rpg sdxl stablediffusion
Last synced: about 1 month ago
JSON representation
Stylized RPG character prompt generator for ComfyUI. Supports SD, SDXL, Flux, and Ollama-driven prompts.
- Host: GitHub
- URL: https://github.com/lord-lethris/comfyui-rpg-characters
- Owner: lord-lethris
- Created: 2025-06-15T03:07:47.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-17T14:30:19.000Z (about 1 year ago)
- Last Synced: 2025-06-17T15:36:36.492Z (about 1 year ago)
- Topics: ai-art, character-generator, comfyui, comfyui-custom-node, comfyui-nodes, custom-nodes, fantasy-characters, flux, ollama, prompt-generator, rpg, sdxl, stablediffusion
- Language: Python
- Homepage:
- Size: 9.51 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ComfyUI-RPG-Characters
A custom node for [ComfyUI](https://github.com/comfyanonymous/ComfyUI) that generates stylized prompts for RPG characters. This node outputs both **standard prompt formats** and enhanced **Ollama-style descriptive prompts** ideal for **extreme close-up portraits**.
✅ Compatible with **Stable Diffusion**, **SDXL**, **Flux**, and any model that uses structured prompts.
This update expands the node to include **Sci-Fi / Cyberpunk character generation**, adding new dropdowns for **Augmentations** and additional Sci-Fi features while retaining all classic RPG options.
---
## ✨ Features
- 🎨 Choose from a variety of art styles:
- Anime Style
- Dark Fantasy
- Realistic
- Fantasy Illustration
- Digital Painting
- Sci-Fi / Cyberpunk
- 🧠 Generates:
- Standard Positive & Negative Prompts (for SD, SDXL, Flux)
- Ollama-style Descriptive Prompt (text-to-text guidance)
- Ollama-style Negative Prompt Instruction
- 📸 Designed for **1024x1024 extreme close-up portraits**
- 📄 Fully structured to support character features:
- Race, Ethnicity, Gender, Age, Class
- Hair & Beard Styles and Colours
- Clothing Style, Emotion, Scene, and Augmentations
---
## 📦 Install via ComfyUI Manager (Recommended 🎉)
The node is now officially listed in **ComfyUI Manager**!
To install:
1. Launch **ComfyUI** and open **Manager** (via sidebar or `custom_nodes` menu).
2. Go to the **Install Custom Nodes** tab.
3. Search for: `RPG-Characters`
4. Click **Install**
5. Restart ComfyUI — you're ready to go!
---
## 🧱 Node Outputs
| Output Name | Description |
|-------------------------------|-------------|
| `positive_prompt` | Standard positive tag string |
| `negative_prompt` | Standard negative tag string |
| `Ollama_Posative_Textbox_1` | Detailed descriptive prompt for LLMs or advanced generators |
| `Ollama_Negative_Textbox_1` | Instructional template to guide LLMs on what to exclude |
| `Ollama_Posative_Textbox_2` | Extra Prompt Food for LLMs or advanced generators that have a second Text Input|
---
## 📂 Example Files
All examples are in the `Examples/` folder of this repository.
### 🧠 Standard Prompt Examples
**Node Setup:**
**Workflow File:**
[`RPG_Nodes_Normal.json`](Examples/RPG_Nodes_Normal.json)
---
### 🧠 Ollama-Driven Prompt Examples
**Node Setup:**
**Workflow File:**
[`RPG_Nodes_Ollama.json`](Examples/RPG_Nodes_Ollama.json)
---
### ⚔️ Comparison: Standard vs Ollama
**Side-by-Side Visual:**
**Workflow File:**
[`RPG_Nodes_Normal_Vs_Ollama.json`](Examples/RPG_Nodes_Normal_Vs_Ollama.json)
---
### 🔁 Prompt Switcher Example
**Prompt Switch Node Example:**
**Workflow File:**
[`RPG_Nodes_Normal_and_Ollama_With_Switch.json`](Examples/RPG_Nodes_Normal_and_Ollama_With_Switch.json)
---
### 🧩 Full Node Collection
A visual reference of the full node layout.
---
## 🛠️ Manual Installation (if needed)
Clone this repo into your ComfyUI `custom_nodes` folder:
```bash
git clone https://github.com/lord-lethris/ComfyUI-RPG-Characters.git
```
Restart ComfyUI after installation.
---
## 🧠 Usage
1. Add the **RPG Art Style Selector** node from the "RPG" category.
2. Select an Art Style from the dropdown.
3. Connect outputs as needed:
- `positive_prompt` / `negative_prompt` → your SD/SDXL/Flux prompt node
- `Ollama_Posative_Textbox_1` / `Ollama_Negative_Textbox_1` → LLM or prompt analysis/feedback tools
---
## ⚠️ Optional Ollama Support Requirements
To use the **Ollama-driven prompt generation** features in this node, you need to:
- Install the [**Ollama server**](https://ollama.com/) on your desired host.
- Download for [macOS](https://ollama.com/download/mac) or [Windows](https://ollama.com/download/windows)
- Install the [**ComfyUI-Ollama node**](https://github.com/stavsap/comfyui-ollama) by Stav Sapir
> Without these installed and running, the Ollama prompt outputs in this node will not function.
---
Credit for the [ComfyUI-Ollama node](https://github.com/stavsap/comfyui-ollama) goes to Stav Sapir ([stavsap](https://github.com/stavsap)).
---
## 🔮 Future Plans
- Dynamic LLM integration for auto-generating character prompts
- Additional art styles (e.g., pixel art, steampunk, noir)
- Visual dropdowns for selecting features (e.g., races, classes, emotions, augmentations)
---
## 🐾 Made by Lord Lethris
Featuring Belle the cat, who disapproves of bad prompts. 🐱