Skip to content

README.md

Latest commit

 

History

History
112 lines (73 loc) · 6.96 KB

README.md

File metadata and controls

112 lines (73 loc) · 6.96 KB
Raw

OpenDirector — animated logo

English | 简体中文

OpenDirector

From an idea to a downloadable short film: generate through chat, organize on a canvas, edit media, and export from a timeline.

OpenDirector is an AI video creation workspace that runs locally and is accessed through your browser. Discuss ideas with the assistant and generate assets, organize and iterate on them on the canvas, edit images, video, and audio, then arrange your material on a timeline and export an MP4.

Use it to explore visual ideas, refine assets, and make short films. Projects stay on your machine; generation uses the provider APIs or self-hosted model services you choose.

News · Example film · Quick start · Documentation · Community · Contributing

News

  • [2026/11/06] We released v0.1.0, the first OpenDirector release, bringing AI-assisted generation, canvas asset management, media editing, and timeline export into one local workspace. See the release notes for highlights and installation instructions.

What you can do

  • Work with AI: Describe what you want to create, reference canvas assets, and ask the assistant to save text or generate content with your configured models.
  • Canvas and reference assets: Upload files, connect nodes, or use @ to add references. Organize assets in one place and review generation history.
  • Media editing: Crop, adjust colors, and work with layers and clips. AI tools such as image extension, erasing, and background removal depend on the connected models' capabilities.
  • Image presets: Select an image, choose Character three-view, Face three-view, Product three-view, Storyboard, or Multi-camera from Presets, then click Generate in the single-row panel. Three-view presets produce one reference sheet each; Storyboard and Multi-camera produce four separate images each, using landscape layouts and retaining a connection to the source.
  • Timeline editing: Arrange assets, adjust start and end points, speed, and volume, then preview and render an MP4. You can also export JSON, FCPXML, and asset bundles.
  • Local projects, your choice of models: The canvas saves automatically to your machine. Configure multiple models for a service and switch between them as needed.

If image generation repeatedly times out or disconnects through a system proxy, open Settings → Model connections → Edit service → Advanced connection and set Network connection mode to Direct connection. This affects that service's model requests and result downloads without changing the system proxy. Check the provider's records before starting another attempt when request acceptance is unknown.

Example film: We Can Still Win

We Can Still Win (《我们还能赢》) is a 60-second short about a middle-aged Dota 2 player.

The screenshot shows the script, video shots, timeline, and finished film. Video generation used FastH3 served through vLLM-Omni.

The We Can Still Win project in OpenDirector, showing its script, six shots, timeline, and rendered film

Actual OpenDirector canvas; click the image to view it at full resolution.

Finished film

dota2-short-film.mp4

Download the original film (MP4, 15.7 MiB) · 60 seconds · 1280 × 720 · 24 fps · Music: 《岁月神偷》.

Quick start

Install with AI

Send this prompt to your AI assistant:

Install and start OpenDirector for me by following this skill: https://github.com/ThinkFlowLab/OpenDirector/blob/main/.agents/skills/install-opendirector/SKILL.md

Manual installation

Source installation requires Python 3.11+, Node.js 24.22.1+ with npm, Git, and FFmpeg/ffprobe with libx264. We recommend a virtual environment to avoid dependency conflicts.

For macOS/Linux, using a python3 that meets the version requirement:

git clone https://github.com/ThinkFlowLab/OpenDirector.git
cd OpenDirector
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .
opendirector serve

Open http://127.0.0.1:8000. Installation builds the frontend automatically; no separate npm commands are needed. See the installation guide for Windows, macOS prerequisites, and updates.

Configure a model service in Settings → Model connections to use AI chat and generation, or upload local media to start editing. The workflow is connect models → generate assets → edit → arrange a timeline → export. See Make your first short film.

Use Chrome or Edge for MP4 export, and keep the page and editor open while rendering.

Documentation

Community

Join the OpenDirector with vLLM-Omni (2) WeChat group to discuss OpenDirector and share your creations. Scan the QR code below in WeChat, or click the image to view it at full resolution.

QR code for the OpenDirector with vLLM-Omni (2) WeChat group

Contributing

We welcome bug reports and suggestions through Issues, and code and documentation contributions through pull requests. See the validation guide (Chinese) for development checks.

License

OpenDirector is released under the Apache License 2.0. See NOTICE for the third-party components distributed with this application and for the artwork under src/assets.