Files
f2027a89f8 feat(config)!: trim Configuration inputs and rewrite tooltips (#150)
Remove settings the user should not have to touch, and make every tooltip
plain-language:

- knowledge_base path: removed; the Knowledge Base ships in the package, so the
  path is fixed rather than a prompted input.
- prompt_target: removed (reserved; to be replaced in V3).
- prompt_separator: removed; always ',' this version. Both keep their compiler
  defaults, just no longer exposed as node inputs.
- analyzer_system_prompt (Configuration) and system_prompt (Scene Analyzer):
  removed. A user-authored system prompt is not UX-friendly; the built-in analyzer
  prompt is always used.
- Rewrite all node tooltips in plain language reflecting the current nodes.

Example workflow and node tests updated; docs/nodes.md refreshed.

BREAKING CHANGE: the Configuration node's knowledge_base, prompt_target,
prompt_separator, and analyzer_system_prompt inputs and the Scene Analyzer's
system_prompt input are removed.

Co-authored-by: kunail0804 <kunail0804@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-16 17:37:28 +02:00
..

Examples

Ready-to-use examples for Scene Compiler.

Workflow

workflows/scene_compiler_pipeline.json is a ComfyUI workflow wiring the full pipeline:

Configuration ─┬─▶ Scene Validator ─▶ Resolver ─▶ Category Splitter ─▶ Prompt Builder
               ├──────────────────────▶ (config)               (config) ◀┘
Knowledge Base Loader ─────────────────▶ Resolver (knowledge_base)
Scene Analyzer ─▶ Scene Validator (scene)

Load it in ComfyUI (Load → pick the file). The Scene Analyzer requires a local Ollama instance; the rest of the pipeline runs offline.

Scene JSON examples

Each scenes/*.scene.json is a Scene JSON document (the Analyzer's output form), and each matching scenes/*.prompts.json is the exact prompt output it compiles to with the shipped Knowledge Base and default configuration:

Scene Highlights
single_character one character, appearance, clothing, environment, camera, lighting
couple_interaction two characters, an interaction, and an expansion (school_uniform → blazer, pleated_skirt)

The *.prompts.json outputs are verified by tests/test_examples.py. To skip the Analyzer and compile a Scene JSON directly, feed it through the Validator → Resolver → Category Splitter → Prompt Builder nodes (or the compiler API).

Note: the workflow JSON is provided as a starting point; verify it loads in your ComfyUI and re-save if ComfyUI adjusts the layout.