whatisgithub

What is open-director?

seme-org/open-director — explained in plain English

Analysis updated 2026-05-18

36TypeScriptAudience · generalComplexity · 4/5Setup · hard

In one sentence

A self hosted, Docker based AI video studio that turns a one sentence idea into a fully produced video using a nine agent pipeline.

Mindmap

mindmap
  root((OpenDirector))
    What it does
      One sentence to video
      Nine agent pipeline
    Tech stack
      Next.js
      Docker
      MySQL
    Use cases
      Creative mode video
      Batch short videos
    Audience
      Content creators
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a single sentence idea into a fully produced video with voiceover and music

USE CASE 2

Mass produce short videos from a list of topics for social media

USE CASE 3

Self host an AI video pipeline instead of using a paid cloud video generator

USE CASE 4

Experiment with different AI model providers for story and image generation

What is it built with?

Next.jsReactTypeScriptMySQLRedisDocker

How does it compare?

seme-org/open-director28998306/magicalcanvasjavlonbek1233/-pixelbattle
Stars363636
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderate
Complexity4/53/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Docker Compose plus API keys for an LLM provider and WaveSpeed image generation.

The README does not state the project's license terms.

So what is it?

OpenDirector is an open source, self hosted AI video production studio. A person types a single sentence describing a video idea, and the system runs that idea through a pipeline of nine specialized AI agents that work together to produce a finished video complete with a script, storyboard, character designs, voiceover, background music, and rendered output. The whole system is designed to run through Docker, so getting started is meant to be as simple as running docker compose up after adding API keys to an environment file. The nine agent pipeline includes a Research Agent that can look up known stories, facts, and brand references, a Script Agent that writes the story outline, an Art Style Agent that picks from a library of built in visual styles, a Storyboard Agent that breaks the story into scenes and shots, a Character Agent that designs characters and assigns voices, a Location Agent that creates settings for each scene, a Voice Agent and BGM Agent that handle text to speech and music, and a Media Agent that pulls everything together into final assets, followed by a render worker that outputs the finished video. OpenDirector offers two main modes. Creative mode runs the full nine agent pipeline from one sentence to a complete video with adjustable aspect ratios and export resolutions. Batch mode is built for producing many short videos at once from a list of topics, with configurable clip length, subtitle styling, and background music, using royalty free stock footage or local video files. The project supports multiple AI providers for text generation, including OpenAI, Google Gemini, DeepSeek, Qwen, MiniMax, and locally run Ollama models, plus pluggable image and media generation providers. The application itself is built with Next.js, React, and TypeScript, and stores data using MySQL, Redis, and MinIO object storage, all wired together through Docker Compose. Both English and Chinese interfaces are supported.

Copy-paste prompts

Prompt 1
Help me write a one sentence prompt that OpenDirector's AI director can turn into a full video
Prompt 2
Show me how to configure the .env file to connect OpenDirector to Gemini and WaveSpeed
Prompt 3
Walk me through what each of the nine agents in OpenDirector's pipeline does
Prompt 4
Help me set batch mode to produce ten short videos from a list of topics

Frequently asked questions

What is open-director?

A self hosted, Docker based AI video studio that turns a one sentence idea into a fully produced video using a nine agent pipeline.

What language is open-director written in?

Mainly TypeScript. The stack also includes Next.js, React, TypeScript.

What license does open-director use?

The README does not state the project's license terms.

How hard is open-director to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is open-director for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.