# roadmaus/comfyui-continuity architecture

> Architecture diagram of the GitHub repository roadmaus/comfyui-continuity, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roadmaus/comfyui-continuity
- Repository: https://github.com/roadmaus/comfyui-continuity

## Overview

Continuity is a ComfyUI extension for generating stills and video, with prompts, attached references, timelines, pre-staging, and optional prompt refinement. The main workflow is a user editing a piece in the browser, submitting it through the Continuity node, and having the node compile and dispatch work to a registered model family; results land in the shared output folder. Chat, timeline/pre-stage, and tool workflows extend that path. The graph follows README statements and the supplied source index; unsampled route and family internals are represented at their enclosing directories, without assuming their call details.

Main entry points: [`web/creator.js`](https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator.js) (Canvas editor), [`creator/creator_node.py`](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/creator_node.py) (Continuity node), [`creator/compile.py`](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/compile.py) (Piece compiler), [`creator/chat.py`](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/chat.py) (Chat room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Creation experience"]
  node_browser["Canvas editor<br/>[creator.js]"]
  node_timeline["Timeline editor<br/>[timeline.js]"]
  node_prestage["Pre-stage<br/>[prestage.js]"]
  node_chat["Chat room<br/>[chat.py]"]
  node_frontend_api["Browser API<br/>[api.js]"]
end

subgraph group_runtime["Render runtime"]
  node_node["Continuity node<br/>[creator_node.py]"]
  node_compiler["Piece compiler<br/>[compile.py]"]
  node_registry["Family registry<br/>[registry.py]"]
  node_queue["Render queue<br/>[jobs.py]"]
  node_refine_routes["Refine endpoint<br/>[refine_routes.py]"]
  node_refine_engine["Prompt refiner<br/>[refine.py]"]
  node_media["Attached media<br/>[media.py]"]
  node_outputs[("Output files<br/>[outputs.py]")]
  node_settings[("Machine settings<br/>[settings.py]")]
end

subgraph group_models["Model execution"]
  node_families["Model families"]
end

subgraph group_capabilities["Tools and media"]
  node_tools["Tool routes"]
  node_neural["Neural refiner<br/>[pipeline.py]"]
  node_screens["Screen tracking"]
  node_preview["Media previews<br/>[preview.py]"]
end

node_user(("Creator"))
node_comfy["ComfyUI core"]
node_refiner_service["Configured refiner service"]

node_user -->|"edits prompt"| node_browser
node_browser -->|"edits shots"| node_timeline
node_browser -->|"creates stills"| node_prestage
node_user -->|"describes scene"| node_chat
node_chat -->|"queues render"| node_queue
node_chat -->|"rewrites prompt"| node_refine_engine
node_browser -->|"submits requests"| node_frontend_api
node_frontend_api -.->|"sends piece"| node_node
node_comfy -->|"runs node"| node_node
node_node -.->|"compiles piece"| node_compiler
node_compiler -->|"resolves family"| node_registry
node_registry -->|"loads family"| node_families
node_node -.->|"queues work"| node_queue
node_families -->|"drives generation"| node_comfy
node_compiler -->|"reads references"| node_media
node_node -.->|"writes results"| node_outputs
node_timeline -->|"feeds start frames"| node_prestage
node_refine_routes -->|"plans rewrite"| node_compiler
node_refine_routes -->|"requests rewrite"| node_refine_engine
node_refine_engine -.->|"calls configured model"| node_refiner_service
node_browser -->|"opens tools"| node_tools
node_tools -.->|"runs material pass"| node_neural
node_compiler -->|"reads screen spec"| node_screens
node_tools -.->|"requests previews"| node_preview
node_browser -.->|"configures machine"| node_settings

click node_browser "https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator.js"
click node_timeline "https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator/timeline.js"
click node_prestage "https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator/prestage.js"
click node_chat "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/chat.py"
click node_frontend_api "https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator/api.js"
click node_node "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/creator_node.py"
click node_compiler "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/compile.py"
click node_registry "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/families/registry.py"
click node_queue "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/jobs.py"
click node_refine_routes "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/refine_routes.py"
click node_refine_engine "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/families/refine.py"
click node_media "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/media.py"
click node_outputs "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/outputs.py"
click node_families "https://github.com/roadmaus/comfyui-continuity/tree/main/creator/families"
click node_settings "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/settings.py"
click node_tools "https://github.com/roadmaus/comfyui-continuity/tree/main/creator/routes"
click node_neural "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/mlxdlss/pipeline.py"
click node_screens "https://github.com/roadmaus/comfyui-continuity/tree/main/creator/screens"
click node_preview "https://github.com/roadmaus/comfyui-continuity/blob/main/creator/preview.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser,node_timeline,node_prestage,node_chat,node_frontend_api,node_comfy toneBlue
class node_node,node_compiler,node_registry,node_queue,node_refine_routes,node_refine_engine,node_media,node_outputs,node_settings toneAmber
class node_families toneMint
class node_tools,node_neural,node_screens,node_preview toneRose
class node_user,node_refiner_service toneIndigo
```

## Components

### Creation experience

- [Canvas editor](https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator.js): `web/creator.js`
- [Timeline editor](https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator/timeline.js): `web/creator/timeline.js`
- [Pre-stage](https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator/prestage.js): `web/creator/prestage.js`
- [Chat room](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/chat.py): `creator/chat.py`
- [Browser API](https://github.com/roadmaus/comfyui-continuity/blob/main/web/creator/api.js): `web/creator/api.js`

### Render runtime

- [Continuity node](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/creator_node.py): `creator/creator_node.py`
- [Piece compiler](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/compile.py): `creator/compile.py`
- [Family registry](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/families/registry.py): `creator/families/registry.py`
- [Render queue](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/jobs.py): `creator/jobs.py`
- [Refine endpoint](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/refine_routes.py): `creator/refine_routes.py`
- [Prompt refiner](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/families/refine.py): `creator/families/refine.py`
- [Attached media](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/media.py): `creator/media.py`
- [Output files](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/outputs.py): `creator/outputs.py`
- [Machine settings](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/settings.py): `creator/settings.py`

### Model execution

- [Model families](https://github.com/roadmaus/comfyui-continuity/tree/main/creator/families): `creator/families`

### Tools and media

- [Tool routes](https://github.com/roadmaus/comfyui-continuity/tree/main/creator/routes): `creator/routes`
- [Neural refiner](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/mlxdlss/pipeline.py): `creator/mlxdlss/pipeline.py`
- [Screen tracking](https://github.com/roadmaus/comfyui-continuity/tree/main/creator/screens): `creator/screens`
- [Media previews](https://github.com/roadmaus/comfyui-continuity/blob/main/creator/preview.py): `creator/preview.py`

### Other components

- **Creator**
- **ComfyUI core**
- **Configured refiner service**

## Connections

- Creator → Canvas editor: edits prompt (evidence: `README.md`)
- Canvas editor → Timeline editor: edits shots (evidence: `README.md`)
- Canvas editor → Pre-stage: creates stills (evidence: `README.md`)
- Creator → Chat room: describes scene (evidence: `README.md`)
- Chat room → Render queue: queues render (evidence: `creator/routes/chat.py`)
- Chat room → Prompt refiner: rewrites prompt (evidence: `README.md`)
- Canvas editor → Browser API: submits requests (evidence: `web/creator.js`)
- Browser API → Continuity node: sends piece
- ComfyUI core → Continuity node: runs node (evidence: `README.md`)
- Continuity node → Piece compiler: compiles piece
- Piece compiler → Family registry: resolves family (evidence: `creator/compile.py`)
- Family registry → Model families: loads family (evidence: `creator/families/registry.py`)
- Continuity node → Render queue: queues work
- Model families → ComfyUI core: drives generation (evidence: `README.md`)
- Piece compiler → Attached media: reads references (evidence: `creator/compile.py`)
- Continuity node → Output files: writes results
- Timeline editor → Pre-stage: feeds start frames (evidence: `README.md`)
- Refine endpoint → Piece compiler: plans rewrite (evidence: `creator/refine_routes.py`)
- Refine endpoint → Prompt refiner: requests rewrite (evidence: `creator/refine_routes.py`)
- Prompt refiner → Configured refiner service: calls configured model (evidence: `README.md`)
- Canvas editor → Tool routes: opens tools (evidence: `README.md`)
- Tool routes → Neural refiner: runs material pass (evidence: `README.md`)
- Piece compiler → Screen tracking: reads screen spec (evidence: `creator/compile.py`)
- Tool routes → Media previews: requests previews
- Canvas editor → Machine settings: configures machine
