What is OpenDirector?

OpenDirector is an open-source AI video production platform where 9 specialized AI agents collaborate to produce complete videos from a single sentence prompt. Built on LangGraph for orchestration, Next.js for the frontend, and FFCreator for rendering, it automates the entire pipeline — from scriptwriting and storyboarding to voiceover, background music, and final video render. It supports both interactive creative mode and automated batch production.

How does OpenDirector work?

OpenDirector uses a 9-agent pipeline orchestrated by LangGraph. The Research Agent gathers context, the Script Agent writes the narrative, the Art Style Agent selects from 34 visual styles, the Storyboard Agent plans shots, Character and Location Agents design visuals, the Voice Agent generates voiceovers, the BGM Agent composes music, and the Media Agent renders the final video. Each agent communicates through a state graph, enabling real-time collaboration and manual adjustments at any stage.

Is OpenDirector free?

Yes, OpenDirector is completely free and open-source under the MIT license. You can use it for personal and commercial projects. The only costs are for the AI API keys you configure (such as OpenAI, Anthropic, or other LLM providers) and any TTS or image generation services you connect.

How do I deploy OpenDirector?

OpenDirector is Docker-first. Clone the GitHub repository, configure your API credentials in the .env file, then run docker compose up to boot MySQL, Redis, MinIO, and the app. Open your browser to start creating. The entire setup takes about 5 minutes on any machine with Docker installed.

What video formats and aspect ratios does OpenDirector support?

OpenDirector supports three aspect ratios: 16:9 cinematic widescreen, 9:16 vertical portrait, and 1:1 square format. Videos can be exported at up to 1080p Full HD resolution. The platform includes 34 built-in art styles across 9 categories, from cinematic and anime to watercolor and neon noir.

Is my data private with OpenDirector?

Yes. Since OpenDirector is self-hosted via Docker, all your scripts, voiceovers, character designs, and rendered videos stay on your local machine. Nothing is uploaded to third-party servers. The only external calls are to the AI APIs you explicitly configure for generation tasks.

Step 9 of 9Rendering Coordinator

Media Agent

Synthesizes images, voices, and audio assets, feeding them to the render worker to compile the final video.

Overview

The Media Agent is the final stage of the pipeline, responsible for assembling all generated assets into a polished video. It collects character images, location backgrounds, voiceover audio, background music, and sound effects from upstream agents, then orchestrates rendering using FFCreator and FFmpeg. The agent handles image composition (placing characters in scene backgrounds with proper layering and parallax depth), subtitle overlay with customizable fonts and positioning, precise audio synchronization across multiple tracks, and video encoding to the target resolution and aspect ratio (16:9, 9:16, or 1:1). It supports output up to 1080p resolution with configurable frame rates. The agent also performs final quality checks — verifying audio levels are normalized, transitions between scenes are smooth, and subtitle timing aligns with voiceover. The output is a fully rendered, publication-ready video file.

Input

All generated assets (images, audio, subtitles)

Output

Final rendered video file (up to 1080p)

Tools

FFCreator renderer, FFmpeg, image composition engine

Related Agents

Step 8—Sound Designer

BGM Agent

Analyzes the script's emotional curve to compose or select matching background soundtracks and audio transitions.

← Previous: BGM Agent View Full Pipeline