transcendedhacker
af352d46ed
Introduces a scalable, production-grade prompt composition system for ComfyUI. Adds pure data libraries, schema-driven rules, a content-agnostic engine, and minimal node interface. Includes documentation (ARCHITECTURE.md, MIGRATION.md, QUICKSTART.md, README.md), three example libraries, and schema configuration for block order, weights, and model profiles.
156 lines
3.7 KiB
Markdown
156 lines
3.7 KiB
Markdown
# Mode_personal_node
|
|
|
|
Ultra-clean, infinitely scalable prompt library system for ComfyUI.
|
|
|
|
## What This Is
|
|
|
|
A production-grade custom node for ComfyUI that uses **pure separation of concerns** to create a maintainable, scalable prompt composition system.
|
|
|
|
### Key Features
|
|
|
|
✅ **Pure data libraries** - No syntax, no weights, no formatting in data files
|
|
✅ **Schema-driven rules** - All logic defined in one connector file
|
|
✅ **Content-agnostic engine** - Core code never changes, only data
|
|
✅ **SDXL & FLUX support** - Model-specific profiles via configuration
|
|
✅ **Infinitely scalable** - Add unlimited libraries without touching code
|
|
✅ **Production-ready** - Clean architecture, no technical debt
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
engine/ → Generic composition logic
|
|
schema/ → Rules defining interpretation
|
|
libraries/ → Pure JSON data files
|
|
```
|
|
|
|
**Three layers, zero entanglement.**
|
|
|
|
Read [ARCHITECTURE.md](ARCHITECTURE.md) for deep dive.
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
1. Copy to `ComfyUI/custom_nodes/Mode_personal_node/`
|
|
2. Restart ComfyUI
|
|
3. Find nodes under "Modular Prompts"
|
|
|
|
See [QUICKSTART.md](QUICKSTART.md) for detailed usage.
|
|
|
|
---
|
|
|
|
## Example
|
|
|
|
**Input:**
|
|
- Library: `realistic_portrait`
|
|
- Character: `Classic Beauty`
|
|
- Scene: `Apartment Evening`
|
|
- Model: `SDXL`
|
|
|
|
**Output:**
|
|
```
|
|
(A woman with soft symmetrical features:1.1), in a small apartment living room, during warm evening light, (quietly reflective mood:1.2), wearing a silk camisole, BREAK, (soft lamp light from the side:1.3), BREAK, shot on 85mm lens, professional photography
|
|
```
|
|
|
|
---
|
|
|
|
## Extending
|
|
|
|
### Add New Library
|
|
|
|
1. Create `libraries/your_theme.json`
|
|
2. Follow structure (see examples)
|
|
3. Restart ComfyUI
|
|
|
|
**No code changes needed.**
|
|
|
|
### Customize Behavior
|
|
|
|
Edit `schema/connector.json`:
|
|
- Block order
|
|
- Weights per block
|
|
- BREAK positions
|
|
- Model profiles
|
|
|
|
**No code changes needed.**
|
|
|
|
---
|
|
|
|
## Why This Architecture
|
|
|
|
**Problems solved:**
|
|
- ❌ Old: Libraries contained formatting → ✅ Now: Pure data
|
|
- ❌ Old: Weights in data → ✅ Now: In schema
|
|
- ❌ Old: Code knew content → ✅ Now: Content-agnostic
|
|
- ❌ Old: Library switching broken → ✅ Now: Works properly
|
|
- ❌ Old: 300s generation time → ✅ Now: Fast, clean prompts
|
|
|
|
**Design principles:**
|
|
- Separation of concerns
|
|
- Data ≠ Logic
|
|
- Schema-driven behavior
|
|
- Scalability without code changes
|
|
|
|
---
|
|
|
|
## File Structure
|
|
|
|
```
|
|
Mode_personal_node/
|
|
├── __init__.py # ComfyUI node interface
|
|
├── engine/
|
|
│ └── composer.py # Core composition engine
|
|
├── schema/
|
|
│ └── connector.json # Rules and structure
|
|
├── libraries/
|
|
│ ├── realistic_portrait.json
|
|
│ ├── fantasy_theme.json
|
|
│ └── cyberpunk_urban.json
|
|
├── ARCHITECTURE.md # Deep dive documentation
|
|
├── QUICKSTART.md # Usage guide
|
|
└── README.md # This file
|
|
```
|
|
|
|
---
|
|
|
|
## Included Libraries
|
|
|
|
1. **realistic_portrait** - Natural photography, everyday scenes
|
|
2. **fantasy_theme** - Magical settings, mystical elements
|
|
3. **cyberpunk_urban** - Neon lighting, futuristic aesthetic
|
|
|
|
Each library is pure JSON data with no embedded logic.
|
|
|
|
---
|
|
|
|
## For Power Users
|
|
|
|
- All formatting logic in `schema/connector.json`
|
|
- Weight adjustments per block
|
|
- Model-specific multipliers
|
|
- Custom BREAK positioning
|
|
- Extensible without code changes
|
|
|
|
This is how professional systems are built.
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
Free to use and modify.
|
|
|
|
---
|
|
|
|
## Philosophy
|
|
|
|
**Libraries are data.**
|
|
**Schema defines rules.**
|
|
**Engine implements rules.**
|
|
**Node wires it together.**
|
|
|
|
Clean. Scalable. Production-ready.
|
|
|
|
Built for people who understand separation of concerns.
|