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.
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 for deep dive.
Quick Start
- Copy to
ComfyUI/custom_nodes/Mode_personal_node/ - Restart ComfyUI
- Find nodes under "Modular Prompts"
See 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
- Create
libraries/your_theme.json - Follow structure (see examples)
- 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
- realistic_portrait - Natural photography, everyday scenes
- fantasy_theme - Magical settings, mystical elements
- 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.