How flashml-org/freevideo works
FreeVideo is a local MiniMax H3 video-inference engine, exposed through a ComfyUI creative workspace and a Linux CLI, with a Windows launcher for setup. The main user flow is to configure an installation, submit a prompt and optional media references, encode conditioning, admit and run a hardware-aware sampling request, then decode and present the video. Separate branches cover model/environment deployment, ComfyUI setup and workflow UI, and resource planning and telemetry. Connections are limited to README statements and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled internals are not asserted.
Main entry points: worker.py Sampling worker · studio.js Studio UI · adaptive.py Adaptive recovery · bootstrap.py Environment setup
Components 18
Creative workspace
- Studio UI
web/studio.js - Setup UI
web/setup.js - ComfyUI plugin
freevideo_engine/comfy_nodes.py
Video inference
- Media encoder
freevideo_engine/encode_worker.py - Sampling worker
freevideo_engine/worker.py - Inference runtime
freevideo_engine/runtime.py - Video decode
freevideo_engine/decode.py - Media request
freevideo_engine/media_request.py
Resource planning
- Resource policy
freevideo_engine/policy.py - Adaptive recovery
freevideo_engine/adaptive.py - Resource history
freevideo_engine/resource_history.py - Device monitoring
freevideo_engine/monitoring.py
Setup and launch
- Windows launcher
freevideo_engine/launcher_session.py - Environment setup
freevideo_engine/bootstrap.py - Downloads
freevideo_engine/network.py - Model storage
freevideo_engine/storage.py
Other components
- Creator
- ComfyUI
Connections 19
- Creator → Studio UI: creates request
README.md - ComfyUI → ComfyUI plugin: hosts plugin
README.md - Studio UI → ComfyUI: calls host API
web/studio.js - Studio UI → Setup UI: opens setup
web/studio.js - Setup UI → ComfyUI: setup requests
web/setup.js - ComfyUI plugin → Media request: admits inputs
- Media request → Media encoder: encodes media
freevideo_engine/encode_worker.py - Media encoder → Sampling worker: provides conditioning
- Sampling worker → Resource policy: plans resources
freevideo_engine/worker.py - Sampling worker → Inference runtime: runs inference
freevideo_engine/worker.py - Inference runtime → Video decode: decodes latents
freevideo_engine/runtime.py - Sampling worker → Adaptive recovery: recovers attempts
freevideo_engine/worker.py - Adaptive recovery → Resource history: reads observations
freevideo_engine/adaptive.py - Adaptive recovery → Resource policy: consults plan
freevideo_engine/adaptive.py - Sampling worker → Device monitoring: samples device
freevideo_engine/worker.py - Creator → Windows launcher: installs runtime
README.md - Windows launcher → Environment setup: sets up environment
freevideo_engine/launcher_session.py - Environment setup → Downloads: downloads packages
freevideo_engine/bootstrap.py - Environment setup → Model storage: records models