-
Notifications
You must be signed in to change notification settings - Fork 3
Available Bundles and Runners
A catalog of what already exists in the dheeai GitHub org — the bundles (pipelines) and runners (node executors) you can run, copy, or depend on instead of building from scratch.
Two kinds of building block:
-
Runner — the code that executes one node (an LLM call, a ComfyUI workflow,
an ffmpeg step). Either built-in (ships inside dhee-core) or ecosystem (a
separate
dhee-runner-*npm package you install). See Authoring a Runner. -
Bundle — a DAG of nodes wired to runners; the thing that produces a finished
video/image/audio. Either a built-in template (in
src/dag/bundles/), a local bundle (~/.kshana/bundles/), or a publisheddhee-bundle-*package. See Authoring a Bundle and Publishing Runners and Bundles.
Built-in (ship inside dhee-core, src/dag/runners/)
No install needed — always registered. The comfy.* ones each drive one ComfyUI
workflow family over the shared comfyExecutor core.
| Tool | What it does |
|---|---|
llm.generate |
Text / JSON generation from a prompt template (story, plans, prompts, treatments). |
comfy.tti |
Text-to-image, no reference images. |
comfy.klein |
Flux 2 Klein reference-edit — a base image + up to 3 reference images. |
comfy.fl2v |
First/last-frame → video. |
comfy.ltx_director |
Multi-shot LTX relay video from seed frames + per-shot prompts. |
comfy.qwen_edit_chain |
Iterative edit-chain shots (each shot conditions on earlier ones). |
vlm.judge |
Vision pass/fail review of an image — powers *_review quality loops. |
ffmpeg.concat |
Stitch clips into the final video. |
ffmpeg.overlay |
Composite a real asset / layer over video (pixel-perfect product/UI). |
ffmpeg.kenburns |
Animate a still with a pan/zoom move. |
ffmpeg.demo_overlay |
Overlay a software/UI demo capture onto background B-roll. |
ffmpeg.shot_clip |
Trim / format a single shot clip. |
cv.captions |
Burn-in captions. |
A bundle that uses one of these declares it in dependencies.runners; if the
package isn't installed the walker fails up front with an npm i … hint.
| Package | Tool(s) | What it does |
|---|---|---|
| dhee-runner-boogu | comfy.boogu |
Boogu image-edit: multi-reference compositing, instruct-edits, view synthesis. |
| dhee-runner-matte | comfy.matte |
SAM 3 concept-segmentation matte — extract a subject on white + mask for compositing. |
| dhee-runner-tts | comfy.tts |
Text-to-speech voice generation. |
| dhee-runner-openrouter-image | openrouter.image |
Image generation via OpenRouter (cloud, e.g. Gemini image). |
SDK: dhee-runner-sdk (
@dheeai/runner-sdk) is the authoring SDK + firewall every external runner imports — it is not itself a node runner. See Authoring a Runner.
A few more runners exist as local packages (
~/.kshana/runners/) and aren't yet published to the org:comfy.vace_place,comfy.ltx_ingredients/comfy.ltx_msr, andimage.grid_stitch(an LTX-reference helper bundle).
Reference one as npm:dhee-bundle-<name> (see Publishing Runners and Bundles).
| Package | What it makes |
|---|---|
| dhee-bundle-narrative-speech-shot-by-shot | Language- & style-agnostic narrative film: story → staging/plates + per-shot continuity → Boogu shot frames → VLM review → per-character voices → LTX talking-head lip-sync, concatenated shot-by-shot. |
| dhee-bundle-ugc-ad-product | Themed product/UGC ad: real product → SAM 3 matte → model-composited into themed scenes → LTX motion → designed + emotive multilingual voiceover → logo end-card. |
| dhee-bundle-ugc-ad-ideogram | Creator-in-scene brand ad: talking head (Klein + LTX) → Ideogram product flyer cutaway → creator-with-product close. Cloned, cross-lingual designed voice. |
| dhee-bundle-cartoon-explainer | Cartoon explainer: Ideogram cartoon scenes + Qwen3 cloned voice + LTX motion. |
| dhee-bundle-openrouter-youtube-documentary | YouTube-style documentary (OpenRouter image/video + LLM). |
| dhee-bundle-infographics | Infographic-style video pipeline. |
Built-in templates (in dhee-core src/dag/bundles/)
The starting points to copy when authoring (see Authoring a Bundle §1):
narrative_text_only (story → plans, no media), ltx_prompt_relay (single-file
minimal), narrative_prompt_relay (images + relay video), narrative_shot_by_shot
(per-shot image→video), narrative_qwen_chain_relay (edit-chain shots),
narrative_text_video, and the *_review variants that add a VLM review loop
(narrative_klein_relay_review, narrative_qwen_chain_review).
Generate a correctly-structured new package in one command:
-
create-dhee-bundle — scaffold a new
dhee-bundle-*package. -
create-dhee-runner — scaffold a new
dhee-runner-*package.
This list is maintained by hand — when a new
dhee-bundle-*/dhee-runner-*repo is added to the dheeai org, add a row here.
Bundles & Runners