Home

dhee-core wiki

dhee-core is a general-purpose generative pipeline engine: a bundle DAG walker, content-addressed cache, runner registry, and the pi-agent that drives it. A bundle is a dependency graph of typed nodes — each node runs an LLM or media-generation call via a runner, and the walker executes them in dependency order with retries, caching, and cascade invalidation built in.

The engine is content-agnostic. It doesn't know whether you're making a film, a music video, an anime storybook, an audio podcast, a poster series, or something completely different — the kind of output is decided by the nodes you wire and the runners they call (outputs.format ∈ image | video | audio | text | json | md), not by the engine. Cinematic video is just the most-built example.

Guides

• Bundles Beginner Guide — what bundles are, the mental model (dependencies, not pipelines), the pieces of a bundle, the four primitives (node kinds / usage / scope / runners), worked examples, and what becomes easy once everything is a bundle.
• Authoring a Bundle — the step-by-step how-to: directory layout, bundle.json field-by-field, picking + pairing a runner with its workflow + manifest, declaring runner dependencies, and validating / test-running a new bundle.
• Authoring a Runner — write the TypeScript module that executes a node: the Runner contract, the bound-vs-generic naming decision, reusing the shared comfyExecutor, registration, credentials, testing.
• Publishing Runners and Bundles — share them as npm packages, ESLint-plugin-style (dhee-runner-* / dhee-bundle-*) that dhee-core discovers and loads.

The authoring guides also ship in-repo as Claude Code skills (.claude/skills/{bundle,runner}-authoring/) — auto-available when you work in a clone — and are installable elsewhere via the in-repo plugin marketplace: /plugin marketplace add dheeai/dhee-core then /plugin install dhee-skills@dhee.

Where things live in the repo

Thing	Path
Bundle schema	src/dag/schema.ts
Walker	src/dag/walker.ts
Runners	src/dag/runners/
Built-in bundles	src/dag/bundles/
Design docs	docs/