LocalMiniDrama

本地离线一键生成 AI 短剧，故事到成片不出机

LocalMiniDrama 是一款开源的本地 AI 短剧与漫剧生成工具，旨在让创作者在完全离线、数据不出本机的环境下，一站式完成从故事构思、分镜设计到视频成片的完整流程。它解决了传统 AI 视频生成依赖云端服务、隐私泄露风险高、工作流分散等问题，通过集成 seedance2 等模型，提供高灵活度的短剧工作流管理平台。核心能力包括：故事脚本生成、分镜规划、AI 真人剧与 AI 漫剧的本地生成，以及基于 Electron 的跨平台桌面应用。项目采用 JavaScript/Node.js 技术栈，强调离线运行与数据主权，适合对隐私敏感或需要定制化创作流程的个人创作者和小型团队。目前项目处于成长阶段，社区活跃度较高，但生态和文档仍在完善中。

开源 free 视频生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1832

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类视频生成

开发团队xuanyustudio

所属国家

官网地址https://83zi.com

GitHubhttps://github.com/xuanyustudio/LocalMiniDrama

定价模式free

价格说明开源项目，MIT许可证，本地部署，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型ai,ai-agent,ai-mini-drama,ai-video,electron,javascript,mini-drama,nodejs,offline,offline-short-drama,open-source,short-video,short-video-maker,storyboard,video-generation,vue,vue3

GitHub 星标★ 1832

30天Star增速

HF 下载量

上线时间2026-02-10 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

一台可安装桌面应用的电脑（Windows / macOS / Linux，Electron 跨平台桌面应用）
自备至少一家 AI 服务商的 API Key（通义 / 火山 / 可灵 / Gemini / Agnes AI 等）
网络可访问 GitHub Releases 以下载安装包（生成过程需调用你配置的 AI API）

安装与启动步骤

1下载安装包

打开项目 GitHub Releases 页面，下载最新版（v1.2.8）对应你操作系统的安装包，README 强调“下载即用”。
2安装并启动

运行下载的安装包完成安装，打开应用即可进入首页，看到项目卡片列表，无需额外命令行操作。
3配置 AI 模型

在应用内分别配置文本、图片、视频三类模型，可一键配置通义 / 火山，或填入 Agnes AI 的单个 Key 覆盖全流程。
4调整 config.yaml

按需修改 config.yaml，写入图床 upload_url、超时（默认 180s）与重试次数，缓存 URL 失效时会自动重传。
5生成短剧

新建项目后按“剧本 → 角色/场景 → 分镜 → 视频合成”流程操作，列表视图精细编辑、画布视图批量编排。

关键配置

配置项	必填	说明	示例
`upload_url`	否	图床上传地址，用于分镜图片上传，缓存 URL 失效自动重传	`https://your-image-host.com/upload`
`超时时间`	否	config.yaml 中的请求超时配置，README 说明默认 180 秒	`180`
`重试次数`	否	config.yaml 中的失败重试次数配置，与图床上传相关	`3`
`文本/图片/视频模型 API Key`	是	三类模型各自独立配置的服务商密钥，需自备	`sk-xxxxxxxx`
`ModelArk AK/SK`	否	火山方舟私有资产库鉴权，支持 AK/SK 与 Bearer 双鉴权	`AKLTxxxxxxxxxxxxxxxx`

如何确认成功

应用正常打开并显示首页项目卡片；三类模型配置保存成功后可生成剧本；素材写入本地 SQLite 与本地文件。

常见问题

Q：必须联网才能用吗？

A：项目主打本地离线运行，素材与项目数据存本地不上云；但生成脚本/图片/视频时需调用你自行配置的 AI 服务商 API，因此需要网络。

Q：数据会被上传到云端吗？

A：不会。项目采用 SQLite + 本地文件存储，素材留在本机，只有你主动调用的 AI 服务商会收到请求。

Q：支持哪些 AI 服务商？

A：README 列出通义、火山、可灵、Gemini 等，v1.2.8 新增 Agnes AI（一个 Key 覆盖文本/图片/视频）以及 ModelArk 私有资产库对接。

Q：图床缓存链接失效怎么办？

A：config.yaml 中可配置 upload_url、超时（默认 180s）与重试次数，缓存 URL 失效时会自动重传。

Q：提示词能改吗？

A：可以。项目提供 9 类提示词，支持自定义覆盖。

注意事项

README 节选中未给出具体安装命令，安装方式以 GitHub Releases 下载页为准，请勿自行 pip/npm 安装本项目。
项目目前处于成长阶段，功能迭代较快，建议关注 CHANGELOG.md 与 v1.2.8 最新动态。
详细 AI 配置方法见官方文档 docs/configuration.md，画布工作流见 docs/plans 下的画布文档。

核心亮点

完全离线运行，数据不出本机，隐私安全有保障
集成 seedance2 模型，支持真人剧与漫剧双形态生成
从故事到成片一站式工作流，降低创作门槛

不足之处

文档/社区待观察
依赖本地硬件性能，生成速度可能受限于设备配置

适用场景

个人创作者离线制作 AI 短剧或漫剧
对隐私敏感的企业内部内容生成
教育或培训场景中快速生成演示视频

替代项目

ShortGPT、DramaMaker、AI-Film

项目介绍

LocalMiniDrama 是视频领域的开源项目，由 xuanyustudio 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,832）位列前 30%，在视频分类的 472 个项目里位列前 14%。

近 45 天，它的 GitHub 星标从 1,192 增加到 1,832，净增 640。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。MIT许可证，本地部署，完全免费。

它主要面向的使用场景是：个人创作者离线制作AI短剧或漫剧。同类可对比的替代方案包括 ShortGPT、DramaMaker、AI-Film。

上一篇：vox-director

下一篇：Causal-Forcing