NidAll-ComfyUI_PromptStyler/STYLE_REVIEW.md

Style Library Review & Expansion Notes

Current Library Snapshot (as of 2026-01-31)

• Total styles: 525 (merged from styles/packs/*.json in filename order).
• Categories are consistent and already cover the big buckets: Photography, Cinema, Illustration, Fine Art, Graphic Design, 3D/CG, Architecture/Interior, Fashion/Product, Nature, Experimental, Color Grade, plus focused sub-buckets (e.g. Photography/Alt Process, Decorative Arts/Textiles, Color Grade/Film Lab).
• Style format is stable: each style has id, name, category, and default.prefix/default.suffix (comma+space separated phrases). The node de-dupes phrases case-insensitively.

Quick checks:

C:\Comfyui\python_embeded\python.exe .\tools\validate_styles.py
C:\Comfyui\python_embeded\python.exe .\tools\audit_styles.py

Deep Review: What’s Working Well

• Atomic phrases: Most templates are written as short, comma-delimited “phrase tokens”, which plays nicely with the node’s phrase splitting + de-dupe.
• Consistent metadata: Styles are uniquely named and tagged; packs are structured consistently.
• Good usability: Category-driven dropdown makes a large library navigable, and packs are additive (contributors can add a new pack without touching existing ones).

Deep Review: Opportunities / Gaps

• Underrepresented mediums: Mixed Media (7) is still relatively small compared to Photography/Cinema. Printmaking has been expanded via Printmaking/Expanded (25), but additional tactile mediums are always valuable for variety and controllability.
• Technique-level styles: Many styles are movement-level (e.g., Impressionism, Cubism). Adding more “how it’s made” styles (materials, surface, process) tends to produce more controllable results across different subjects.
• Prompt token consistency: The node splits on ", " (comma + space). Avoid using commas without a following space inside a single token, or the phrase won’t split as expected.

Style Text Rules (Accuracy + No Object Injection)

• Style-only phrasing: Prefer medium/process/palette/lighting/composition/texture cues. Avoid introducing unrelated objects not implied by the style name.
• Specific stays specific: If a style is explicitly scene/subject-based (reflected in its name), keep its defining nouns (e.g., Portrait, Street, Interior).
• No gear words in templates: Avoid photography/cinema equipment terms in prefix/suffix/Flux prose (e.g., softbox, strobe, beauty dish, tripod, lens). Prefer effect language (diffused key light, wide field of view, compressed perspective).
• Portrait/fashion OK cues: Skin texture, catchlights, and sharp eyes are acceptable quality cues.

Academic / Museum References (for future refinements)

When tightening a technique or movement, prefer authoritative glossaries and museum/encyclopedia references (examples):

• Printmaking processes (etching, aquatint, mezzotint), and chiaroscuro definitions: Encyclopedia Britannica; National Portrait Gallery (UK) glossary.
• Cyanotype process characteristics: National Gallery of Art (USA) and similar museum education references.
• Film noir traits (low-key lighting, high-contrast look, mood conventions): established film history references (e.g., Britannica / major film institutes).

New Additions: Fine Art/Artists Pack

Added styles/packs/34_fine_art_artists.json with 25 artist-referenced styles under Fine Art/Artists. Each style is written to stay subject-agnostic (palette, brushwork, surface, composition, light) and avoid photo/cinema gear terms.

Research references used while drafting these templates (high quality / museum / encyclopedia sources):

• Encyclopaedia Britannica (artist biographies + movement/technique definitions): https://www.britannica.com/
• The Metropolitan Museum of Art (movement essays and collection learning resources): https://www.metmuseum.org/
• The Museum of Modern Art (artist/movement resources, e.g. action painting / Pollock): https://www.moma.org/

New Additions: 500-style Expansion Packs

Added four focused packs (25 styles each) to reach 500 total styles:

• styles/packs/21_photography_alt_process.json (Photography/Alt Process) - alternative photo processes, printing looks, darkroom effects.
• styles/packs/31_printmaking_expanded.json (Printmaking/Expanded) - broader printmaking techniques beyond the core set.
• styles/packs/41_decorative_arts_textiles.json (Decorative Arts/Textiles) - fiber/textile techniques and tactile fabric aesthetics.
• styles/packs/97_color_grade_film_lab.json (Color Grade/Film Lab) - film lab looks (scan/process/stock-inspired grades and artifacts).

New Additions: Decorative Arts Pack

Added styles/packs/38_decorative_arts.json with 12 “material/process-first” styles under the new Decorative Arts category. Each is designed to be subject-agnostic (it pushes materials, surface, and craft cues rather than forcing a specific object).

Highlights:

• Kintsugi Ceramics: glazed pottery textures + gold-filled crack seams; calm wabi-sabi mood; controlled reflections.
• Cloisonné Enamelwork: fine metal partitions, jewel-toned enamel cells; crisp boundaries; glossy speculars.
• Urushi Lacquerware (Maki-e): deep lacquer blacks/reds, subtle gold dust ornament; mirror-like finish; refined minimalism.
• Marquetry Wood Inlay: veneer grain + precise inlay boundaries; warm tones; polished sheen.
• Batik Textile: wax-resist crackle, dye diffusion, cloth weave; earthy palettes; handmade irregularities.
• Sashiko Stitching: indigo cloth + white running stitches; geometric patterns; visible thread relief.
• Jacquard Tapestry Weave: dense woven patterns; fiber fuzz and weave depth; warm ambient presentation.
• Paper Quilling Filigree: rolled paper coils + delicate curls; crisp cut edges; macro shadows between layers.
• Suminagashi Marbling: minimal ink rings and soft swirls; paper grain; calm negative space.
• Ebru Marbling (Vibrant): high-saturation swirling pigments; fluid motion; artisanal diffusion.
• Alcohol Ink Blooms: translucent gradients + sharp diffusion edges; pigment pooling; glossy highlights.
• Millefiori Glasswork: colorful internal cane motifs; translucent depth; caustic highlights.

New Additions: Internet Aesthetics Pack

Added styles/packs/39_internet_aesthetics.json with 43 “mood-first” styles organized under Aesthetics/ subcategories (Liminal, Horror, Retro Future, Tech, Neon, Maximal, Core). Each entry includes a detailed models.flux_2_klein.suffix description (lighting, mood, texture, palette) to make the intent explicit.

Highlights:

• Dreamcore / Weirdcore / Liminal Spaces / Backrooms / Dead Mall / Poolrooms: empty, nostalgic, uncanny spaces with soft haze and institutional lighting cues.
• Analog Horror / Emergency Broadcast / Found Footage / Lost Media / Hauntology: CRT/VHS artifacts, warning overlays, degraded archives, and “memory haze” nostalgia.
• Retrofuturism / Cassette Futurism / Atompunk / Dieselpunk / Raygun Gothic / Googie / Steampunk / Clockpunk / Biopunk: distinct eras of futurism and material language (chrome-plastic optimism → beige 80s utilitarianism → riveted soot-metal industry → ornate brass clockwork → wetware biotech).
• Frutiger Aero / Dark Aero / Frutiger Metro / Webcore: screen-era aesthetics (glossy aqua optimism, tech-noir glass, transit UI grids, early-web glitter clutter).
• Synthwave / Darksynth / Dreamwave / Future Funk / Mallsoft / Hardvapour / Seapunk / Hyperpop / Glitchcore: neon sub-aesthetics ranging from romantic haze to industrial aggression to candy-chrome maximalism.
• Cottagecore / Fairycore / Goblincore / Angelcore / Dark Academia / Whimsigoth / Pastel Goth: cozy-to-goth “core” aesthetics with clear palette and texture direction.

Node UX Update: Disabling Styles

The node now includes apply_style (BOOLEAN). When disabled, the node passes the prompt through unchanged and only performs CLIP tokenization/encoding.

Node UX Update: Flux Variant + Direct ID

• template_variant: choose default (comma-phrase templates) or flux_2_klein (use models.flux_2_klein.suffix prose guidance when available).
• style_id_override: apply a style directly by id (useful for freshly-added user styles without reloading nodes).

User Style Wizard

Use the CLI wizard to add styles into styles/packs/99_user_custom.json (gitignored) under User/<Subcategory>:

C:\Comfyui\python_embeded\python.exe .\tools\add_styles.py wizard

Web Search Plan (for Future Style Expansion)

Goal: identify additional medium/process styles and capture them as prompt-friendly tokens (materials, texture, palette, lighting, composition).

Suggested sources to mine:

• Museum education glossaries (MoMA, Tate, Met) for technique vocabulary.
• Wikipedia “List of art techniques” and printmaking/book-arts pages for breadth.
• Conservation/craft references (ceramics glazing, metal patina, textile techniques) for surface descriptors.

Example query patterns:

• “{technique} texture terms” (e.g., “encaustic texture terms”, “mezzotint texture”)
• “{medium} lighting tips” (e.g., “glossy lacquer photography lighting”)
• “{craft} visual characteristics” (e.g., “sashiko stitching characteristics”)

Conversion checklist (from search notes → PromptStyler entry):

1. Medium/material: what it’s made of (glass, enamel, lacquer, fiber, paper).
2. Surface cues: gloss vs matte, grain, crackle, weave, tool marks.
3. Color/palette: typical pigments, saturation, tonal range.
4. Pattern/composition: repeating motifs, symmetry, negative space.
5. Lighting: studio/product lighting vs diffuse ambient to emphasize texture.