CineFlow Studio
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CINEFLOW_API_KEY | No | CineFlow API key enabling Cloud director mode for narrative planning, cross-scene continuity, and reference policy. | |
| CINEFLOW_CLOUD_URL | No | Optional CineFlow cloud server URL used with CINEFLOW_API_KEY. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cineflow_quick_ttsB | Single-shot high fidelity speech synthesis (Higgs v3 / Qwen TTS) with emotion and optional voice cloning. |
| cineflow_quick_photo_animateA | Animate any still portrait or product photo into a 5-8 second cinematic video clip via LTX 2.5. |
| cineflow_quick_reelC | Create an assembled commercial montage reel from a folder of source media assets. |
| cineflow_project_createC | Initialize a new cinematic project in the studio database and storage directory. |
| cineflow_materials_attachC | Register characters, props, and locations for the project and generate turnaround cards for human approval. |
| cineflow_dialogue_ttsC | Render all dialogue audio lines for the project to establish exact shot timing and audio pacing. |
| cineflow_frames_generateC | Generate starting keyframes for shots. Enforces reference policy (every must be addressed in prompt). |
| cineflow_video_renderB | Render motion video clips for shots via MiniMax H3 / LTX 2.5. Enforces closed-mouth guard on non-dialogue clips (#600). |
| cineflow_export_mp4B | Stitch rendered video clips, dialogue tracks, and background music into the final exported MP4 timeline. |
| cineflow_statusB | Inspect system health, ComfyUI backend reachability, active GPU jobs, and project status. |
| cineflow_cloud_script_planA | Cloud mode: upload the script to the CineFlow server, enqueue the plan job, and wait for it (bounded). Requires CINEFLOW_API_KEY. |
| cineflow_billing_statusA | Check current billing status: community (local ComfyUI) mode and whether a CineFlow API key is configured. The tier and entitlements are decided by the CineFlow server, not by this client. |
| cineflow_authA | Store a CineFlow API key for cloud calls. Saving is not verification: the tier and entitlements are decided by the CineFlow server on each cloud call. |
| cineflow_davinci_syncB | Synchronize project timeline, shots, and audio directly with DaVinci Resolve (or export FCPXML 1.10). Automatically installs the 'CineFlow: Edit in ComfyUI' action script for round-trip clip editing. |
| cineflow_project_initC | Initialize a physical project directory tree on disk. Stores original screenplay/book in source/, creates project.json as canonical Source of Truth, and provisions materials/ and scenes/ subdirectories. |
| cineflow_projects_listB | List all existing projects in studio storage with summaries of their characters, locations, scenes, and production stages. |
| cineflow_assets_transferA | Transfer and clone characters, locations, or props from an existing project into the current target project. Automatically copies turnaround cards, plates, and voice models into target materials while maintaining project.json continuity. |
| cineflow_project_get_stateB | Read the canonical Source of Truth (project.json) manifest. Returns project stage, approved characters, active scene, and production history. |
| cineflow_project_update_stateB | Update the canonical Source of Truth (project.json) manifest. Automatically tracks changes and reports impact warnings on downstream shots (e.g. if character appearance is changed after generation). |
| cineflow_scene_activateB | Activate a specific scene for production. Provisions dedicated scenes/scene_XX/ directory with frames/, audio/, and video/ subfolders, and updates project.json stage. |
| cineflow_hardware_profileA | Inspect local computer hardware (OS, CPU, RAM, GPU, VRAM) and recommend the optimal ComfyUI memory profile (rtx_24gb, rtx_16gb, rtx_12gb, apple_silicon, or cloud_only). |
| cineflow_installer_auditC | Audit local ComfyUI installation, checking for installed vs missing model weights (HuggingFace) and custom nodes readiness percentage. |
| cineflow_generate_launcherB | Generate a supervised ComfyUI launch script (run_comfy_cineflow.sh or .bat) preconfigured with optimal VRAM flags for the user's GPU. |
| cineflow_cache_cleanupB | Clean up temporary latents in output/latents/ and preview cache (#608) to free SSD space. |
| cineflow_scene_graph_getB | Retrieve the Directed Scene Graph, including nodes, narrative edges/cuts, continuity carryover, and timeline sequence. |
| cineflow_scene_graph_updateC | Update the Directed Scene Graph: nodes, transitions (CUT, MATCH_CUT, CROSSFADE, L_CUT, J_CUT, SMASH_CUT), and timeline sequence. |
| cineflow_scene_directing_setC | Set director explication for a scene: emotional arc, camera style, color palette, lighting setup, beat sheet, and continuity. |
| cineflow_comfy_config_getC | Get ComfyUI environment paths (comfy_dir, models_dir, custom_nodes_dir) and active API URL for the project. |
| cineflow_comfy_config_setB | Configure and save ComfyUI directory paths and API URLs for the project (stored in settings/comfyui.json). |
| cineflow_shot_record_artifactB | Record a generated shot artifact, saving the exact ComfyUI workflow JSON and creating a sidecar .cineflow.json alongside the media. |
| cineflow_models_catalogB | List models and weights with direct download links (HuggingFace, hf-mirror, ModelScope), file sizes, target directories, and curl commands. |
| cineflow_nodes_catalogA | List all verified ComfyUI custom nodes required for video, turnaround, and speech generation with git clone URLs. |
| cineflow_workflows_catalogB | Catalog of verified ComfyUI workflow templates (LTX-Video img2vid, FLUX turnaround, Higgs TTS, MiniMax H3). |
| cineflow_workflow_getB | Retrieve the exact ComfyUI JSON node graph blueprint for a specific workflow template. |
| cineflow_install_nodeB | Clone or update a ComfyUI custom node into custom_nodes/ and install its requirements.txt dependencies. |
| cineflow_download_modelB | Download a model weight into the correct ComfyUI folder (checkpoints, unet, loras, tts) with resume support or return the curl command. |
| cineflow_generate_dependency_scriptA | Generate an all-in-one bash/bat script (install_cineflow_models.sh) that clones all custom nodes and downloads all weights with resume support in 1 click. |
| cineflow_check_updatesA | Check parent CineFlow repository for newly released features, models, workflow blueprints, or studio updates. |
| cineflow_apply_updateB | Safely pull upstream parent repository updates, refresh skills in .kimi-code and .agents, and update DaVinci Resolve scripts. |
| cineflow_deepseek_statusB | Probe and verify internal or local LLM server (DeepSeek, Qwen 2.5, Llama 3, Mistral via vLLM, Ollama, SGLang, llama-server) status, models, and studio topology (Topology 1: Single-GPU External LLM vs Topology 2: Dual-Server Internal Cluster). |
| cineflow_internal_llm_statusC | Universal probe for internal/on-premise LLM servers (DeepSeek, Qwen 2.5, Llama 3, Mistral) and multi-server studio topology. |
| cineflow_vision_inspectB | Inspect and evaluate keyframes/takes via Qwen 3.8 Vision co-located inside ComfyUI: aesthetic quality, artifact/defect detection, lip-sync closed-mouth guard (Issue #600), and English reference auto-captioning without VRAM conflicts. |
| cineflow_comfy_workflow_executeB | Assemble, parameterize, save, and queue a ComfyUI workflow graph (LTX, FLUX, Qwen Vision CV, or Higgs TTS). Saves reproducible .comfy.json and sidecar .cineflow.json alongside shot media. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| direct_scene | Interactive director co-pilot for planning, blocking, character continuity, and ComfyUI generation of a scene. |
| audit_continuity | Audit character cast slots, costume consistency, dialogue speakers, and reference slot assignments. |
| transfer_universe_assets | Transfer heroes, locations, or props from an existing project into a new movie or episode with provenance tracking. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Studio Projects Inventory | List of all registered projects, production stages, cast sizes, and scene counts. |
| ComfyUI Models Catalog | Comprehensive inventory of weights (LTX, FLUX, Qwen Vision CV, Higgs TTS) and hardware profiles. |
| ComfyUI Workflows Catalog | Verified ComfyUI pipeline blueprints (photo-to-video, turnaround cards, speech cloning, CV inspection). |
| Hardware & VRAM Profile | Current machine hardware profile (GPU model, VRAM capacity, CPU cores, recommended flags). |
TDQS
Scored across 43 tools
Several pairs have unclear boundaries: cineflow_project_create vs cineflow_project_init, cineflow_quick_tts vs cineflow_dialogue_tts, cineflow_nodes_catalog vs cineflow_install_node, cineflow_models_catalog vs cineflow_download_model, and cineflow_workflows_catalog vs cineflow_workflow_get vs cineflow_comfy_workflow_execute. Status probing is especially fragmented across cineflow_status, cineflow_billing_status, cineflow_internal_llm_status, cineflow_deepseek_status, and cineflow_hardware_profile, where an agent could easily pick the wrong probe.
All tools use a cineflow_ prefix and snake_case, but conventions mix: verb_noun (cineflow_install_node, cineflow_download_model), noun_verb (cineflow_comfy_config_get, cineflow_workflow_get), and noun-only (cineflow_status, cineflow_auth). Ad-hoc prefixes like quick_ (quick_reel, quick_tts, quick_photo_animate) create a third naming family that doesn't map cleanly onto the rest of the lifecycle verbs.
43 tools is far above a comfortable surface for one server and several are redundant (multiple status probes, duplicate catalog/download/config get-set families). The scope spans production pipeline, infrastructure install, dependency management, and billing/auth, which is too broad to navigate reliably as one toolset.
The creative lifecycle is broadly covered: project state, scenes, scene graph, materials, frames, video render, TTS, export, plus infra and install tooling. However there are notable gaps in teardown/cleanup of projects, scenes, or materials (no delete/remove operations), leaving the CRUD surface one-sided.