guaardvark Film Crew with Guaardvark
Read setup first. Needs comfyui; casting with trained characters needs
lora_trainer (see the cast skill). Renders take minutes per shot.
Start: MCP start_film_crew
script_text: a screenplay or a plain scene list. A logline works; the screenwriter expands it.name(defaults to the first line),video_model(defaults to the active scene model,minimax-h3-int8on a typical box;wan22-5bfor silent i2v).- The screenwriter starts at once. Casting, storyboards and GPU renders wait for the user in Studio (Agents > Film Crew) or through the routes below.
Stages and gates (REST)
B=${GUAARDVARK_URL:-http://localhost:5000}, P = production id from the tool.
| stage | call | note |
|---|---|---|
| status | GET $B/api/production/$P |
stage, subjects, shots, errors |
| subjects found by the writer | GET $B/api/production/$P/subjects |
characters, environments, props |
| cast one subject | POST $B/api/production/$P/cast/<subject_id> with {"action": ...} |
link to an existing Cast Library subject or plan a new one |
| confirm casting | POST $B/api/production/$P/casting/confirm |
user gate: every subject needs a cast plan first |
| storyboard shot image | GET $B/api/production/$P/storyboard/shot/<shot_id>/image |
review keyframes |
| redo one shot | POST $B/api/production/$P/storyboard/shot/<shot_id>/regenerate |
|
| approve storyboard | POST $B/api/production/$P/storyboard/approve |
user gate: releases the renders |
| retry a failed stage | POST $B/api/production/$P/retry |
|
| list / delete | GET $B/api/production, DELETE $B/api/production/$P |
Without the MCP tool: POST $B/api/production with {"name", "script_text", "settings": {"video_model": "..."}}.
How to run it well
- Show the screenwriter's output (scenes, shots, subjects) before touching casting.
- Consistent faces come from trained LoRAs. If a subject has no Cast entry, offer to create and train one (the cast skill) or cast it "as described" and warn identity may drift.
- State the render cost before the storyboard approval: shots × seconds × model speed.
- The editor assembles the shots in the Video Editor; the result appears in the media library.
- Nothing posts or uploads. The film stays on the machine unless the user moves it.