Skip to content

xuanyustudio /LocalMiniDrama

Free desktop app for AI short dramas and comic dramas on your computer
PlatformMITChinese README
Stars
2.5k
30 days
+353
Last push
today

About LocalMiniDrama

LocalMiniDrama is a free desktop app for AI short dramas and comic dramas. It runs on your own computer, so scripts and assets stay local. You bring your own API keys for paid model providers like DashScope, Volcengine and Kling. The README is mostly Chinese; an English version sits at docs/en.md.

Best for: Small teams that want a local workspace and can supply their own model API keys.

What it does

  • Runs 8 steps: story, script, characters, scenes, props, storyboard, video, compositing
  • Generates the whole chain in one click and skips parts you already made
  • Lets you edit shots on a canvas with per-shot pipelines and group re-runs
  • Sets up text, image and video models separately, with 9 prompt categories
  • Exports and imports projects as ZIP, plus a shared asset library
  • Supports 16:9, 9:16 and 1:1 frames, light and dark themes

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Download the standard or Lite .exe from the GitHub Releases page and double-click it.
  2. 2
    Open the AI configuration screen, paste your API key, and start creating.
  3. 3
    Or build from source with Node.js 18 or newer: the command below then cd LocalMiniDrama.
    git clone https://github.com/xuanyustudio/LocalMiniDrama.git
  4. 4
    Start the backend: the command below, the next command (add your API keys), npm run migrate && npm start.
    cd backend-node && npm install
    cp configs/config.example.yaml configs/config.yaml
  5. 5
    Start the frontend in a new terminal: the command below.
    cd frontweb && npm install && npm run dev
  6. 6
    Open http://localhost:3013, or double-click run_dev.bat in the repo root.

Models and languages

Models it works with

  • Seedance 2.0
  • Jimeng 1.0
  • Kling
  • Tongyi Wanxiang
  • Vidu
  • Google Gemini
  • NanoBanana
  • Agnes AI
  • Doubao
  • Ollama

Interface and docs

  • Chinese
  • English

Common questions

What people ask when they look this repo up, answered from its issues and docs.

Does LocalMiniDrama run on Mac?
Only some versions: v1.2.6 had .dmg files for Intel and Apple Silicon Macs, and v1.2.7 had one for Apple Silicon. The newest release, v1.2.8 (July 2026), is Windows only. The docs also say only Windows has been tested. Source
Is LocalMiniDrama free, and can it run fully offline?
The app is free (MIT license, no subscription), but you pay your AI providers for every image and video. Local models like Ollama only cover the text step. Images and video still go to a cloud API, so it isn't fully offline. Source
How do I turn off "vendor lock mode" in LocalMiniDrama?
Set vendor_lock: enabled: false in backend-node/configs/config.yaml. That works right away in dev mode. With the exe, a maintainer says you need to rebuild the desktop app after the change. Source
Why does my merged video only show the first shot?
Most often ffmpeg is missing. The owner says to check the ffmpeg files in the tools folder. A similar bug with Volcengine was fixed in v1.2.2, so update first if you're on an older build. Source
Can I use OpenRouter with LocalMiniDrama?
Yes. Add it as an OpenAI-compatible provider, not as Gemini. With the Gemini type, the connection test builds the wrong URL and fails. Source
Where does LocalMiniDrama keep its config file?
With the exe, the first launch creates config.yaml in %APPDATA%\LocalMiniDrama\backend\configs\. In dev mode it's backend-node/configs/config.yaml. You can also enter API keys in the AI config screen and test the connection there. Source
Can LocalMiniDrama chain one shot's last frame into the next shot?
Yes, since v1.2.7. The tail-frame link takes the last frame of a finished shot video and sets it as the next shot's first frame. You can also export an episode's storyboard as an HTML table to review with others. Source

Alternatives

Other platform projects people compare with LocalMiniDrama.

Stonewuu

ai-fusion-video

Keeps scripts, storyboards, assets and clips in one self-hosted workspace

Platform
  • Anthropic
  • Gemini
  • DashScope
  • +1
1.8k GitHub stars+139/30dyesterdayMIT

alibaba

lumenx

Feed it novel text, get a motion-comic short drama with dialogue

Platform
  • Wan 2.7 Image/Video
  • Seedance 2.0
  • Kling V3
  • +7
1.5k GitHub stars+103/30d19 days agoMIT

HITsz-TMG

VideoClaw

AI director that turns one idea into a full short drama or comic drama

Platform
  • Wan 2.7
  • Kling v3 / v2.6 / v2.5
  • Seedance 2.0
  • +7
1.9k GitHub stars+46/30d2 months agoMIT

HBAI-Ltd

Toonflow-app

One infinite canvas for AI short dramas and comic dramas

Platform
  • Seedance 2.0
  • GPT Image 2
  • Claude Opus 4.6
  • +2
22k GitHub stars+4k/30dyesterdayMIT

Featured on OpenMicroDrama

Do you maintain LocalMiniDrama? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/xuanyustudio-localminidrama)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 13, 2026. We write these descriptions ourselves. The repo's own docs are the final word.