开源项目解析
Jellyfish
AI 短剧的端到端工作台:从剧本进,到分镜、角色一致性管理、出片、导出。
这一类里源码最全前后端契约走 OpenAPI社区在质疑它的星数
读懂层
2 张 · 架构图 / 时序图
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
前端 React、后端 FastAPI,`chains/` 放 AI Agent,`services/` 放业务,`models/` 是 ORM,对外契约走 OpenAPI —— 前端的请求函数与类型是从 OpenAPI 生成的,不手写。
它管哪几个决定
自持能力
权重在不在本地只能调接口
种子能不能填不可填
换掉它要动几处一处
模型管理是独立模块,换供应商在界面里配,不改代码
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1起后端Python 侧用 uv;先跑 `init_db.py` 与 `init_storage.py`,少一步后面全是找不到表
- 2起前端`pnpm install`
- 3配模型在模型管理里配 key。账单会很快 —— 全链路都在调大模型
改哪个文件能改什么
backend/app/chains/AI Agent 都在这里。改生成逻辑从这里进backend/app/api/v1/routes/接口定义。改了要重新生成前端的类型front/src/界面。请求函数由 OpenAPI 生成,别手改坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
跑不起来issue #24「有没有跑起来的举个手」回复 8 条、#4 `ModuleNotFoundError: No module named 'app.utils'` —— 都已关闭,但装的时候仍要按顺序初始化
费用issue #9「TOKEN 消耗太吓人了」 —— 剧本、分镜、图、片全走模型,跑一集的账单要先估
看不到成品issue #1 问「哪里能看到系统做出来的成片」 —— 决定要不要投时间之前,这一条挺关键
教程
没找到官方口径的教程 —— 官方只给了 README。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
Jellyfish — AI Short Drama Studio English · 日本語 An end-to-end production workspace for AI-generated short dramas. From script input to structured storyboarding, consistency management, shot preparation, video generation, and export. 📷 Screenshots | Project overview | Asset management | ✨ Core Value - Connect the full production flow: Move from script input to storyboard preparation, image/video generation, and task tracking in one place. - Turn AI output into reusable production assets: Shots, candidate assets, dialogue, prompts, and generation tasks can all be reviewed and reused. - Treat consistency as a first-class problem: Centralized character, scene, prop, and costume management reduces drift across shots. - Handle long-running generation as trackable tasks: Text, image, and video jobs all go through one async task system with status, cancel, and recovery. - Build AI capability as infrastructure: Model management, prompt templates, files, and OpenAPI-based collaboration make the system extensible. ✨ Core Capabilities Jellyfish is not just a single “AI image/video” utility. It is a production workspace built around: - script understanding - shot preparation - asset consistency - generation execution - task tracking 1. AI script understanding and storyboard breakdown - Split chapter scripts into shots - Extract characters, scenes, props, costumes, and dialogue - Run script optimization, simplification, and consistency checks - Support targeted analysis such as character portraits or scene details 2. Shot preparation and confirmation workflow The main workflow is: script breakdown → shot preparation → candidate confirmation → shot ready → generation workspace Preparation currently supports: - extracting and refreshing shot candidates - accepting or ignoring asset candidates - accepting or ignoring dialogue candidates - linking existing characters, scenes, props, and costumes - correcting shot-level basic information - using a unified readiness state to decide whether a shot is prepared 3. Asset consistency and reuse The system maintains a shared entity model across: - characters / actors - scenes - props - costumes This supports asset reuse across shots and helps stabilize style and identity. 4. Shot-level image and video orchestration Once a shot is ready, the generation workspace supports: - keyframe and reference image management - shot-level video prompt preview - image and video generation tasks - single-shot and batch pre-checks - writing generation outputs back into the shot/media system 5. Unified async task center Current task infrastructure supports: - async text-processing tasks - async image and video generation tasks - unified task status, result, and elapsed-time tracking - task cancellation - a global task center with context-aware navigation back to project/chapter/shot 6. Model, prompt, and generation infrastructure Supporting capabilities include: - multi-provider / multi-model management - default model settings by category - prompt template management - file and generated media management - OpenAPI-driven frontend/backend contracts 🚀 Feature Overview Project and chapter management ……(后略,见原文)
判断
优势
- Apache-2.0 且源码是全的 —— 这一类里少见
- 前后端契约走 OpenAPI 自动生成,二次开发时接口不会两边对不上
- 模型管理、提示词模板做成了可扩展模块,不是写死一家
- 自带单元与集成测试
局限
- issue #24「有没有跑起来的举个手」、#22「一大堆问题,根本没法用」 —— 都已关闭,但问题问出来了
- issue #9「TOKEN 消耗太吓人了」 —— 全链路走大模型,账单是真实成本
- issue #1「请问哪里能看到系统做出来的成片?」 —— 官方至今没给成片样例
- issue #17「现在刷 Star 的真多,图啥」 —— 五个月涨到近六千星,这个速度它自己的社区都在质疑
不适用
想开箱即用的人 —— 它是给二次开发者的工作台,不是给创作者的成品软件。
同管这些决定的其它项目
ComfyUI节点式工作流底座。图像 / 视频 / 音频 / 3D / 文本共用一个底座。…Wan2.2文生 / 图生 / 语音驱动 / 角色动画替换,480P–720P。五个变体。…HunyuanVideo腾讯的开源视频生成模型,文生视频与图生视频。720×1280、129 帧。…FramePack把 13B 视频模型压进 6GB 显存的桌面程序。图生视频,一分钟长度、30 帧。…LTX-VideoLightricks 的视频生成模型,主打快。文生 / 图生 / 视频续写,默认 1…MiniMax H3全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz…IP-Adapter用图片当提示词,锁住风格或人物。仅 22M 参数。…InstantID一张脸照做身份保持生成,零样本、免调优。…Real-ESRGAN通用图像 / 视频超分修复,支持 2× / 3× / 4×,含动漫专用与轻量模型。…Practical-RIFE视频插帧:在两帧之间算出中间帧,把 24 帧的片子补成 48、60 帧。作者是 RI…CodeFormer人脸修复:把糊掉、压坏、老照片里的脸修回来。图片与视频都能做。…kohya sd-scripts训练脚本集:覆盖 SD1.x/2.x、SDXL、SD3/3.5、FLUX.1;202…musubi-tuner视频模型的 LoRA 训练器。同一套代码训 Wan 2.1/2.2、HunyuanV…Ollama一条命令在本机跑开源大模型。写脚本、翻译这两段靠它才不出本机。…DiffSynth-Studio魔搭扩散模型工程框架,覆盖图像、视频、音乐推理与训练;近期加入 FLUX.3、MOS…MoneyPrinterTurbo给个主题或关键词,一键出高清短视频,含字幕与配音。…NarratoAI用大模型一键解说并剪辑现成视频。…火宝短剧基于 AI 的一站式短剧生成平台,从剧本到成片全自动化。…ToonflowAI 创作平台:无限画布、AI Agent、可视化工作流,支持图像、视频、分镜和短剧…infinite-canvas面向 AI 创作的无限画布工作台:生图、参考图编辑、视频生成、Agent 助手、画布…open-ai-canvas面向 AI 影视创作的无限画布:多模态生成、分镜编排、素材管理、Agent 工作流。…VOZEB PRO把统一创作 Agent、画布、短剧生产线、素材库和商业运营后台放进同一套 Next.…OpenMontage让 Agent 编排视频生产:通过声明式流水线组织素材、生成、字幕、音频与合成。…video-shotcraft为 Claude Code / Codex 提供产品宣传片镜头配方,以网页截图与文案…Generative Media Skills给 Agent(Claude Code / Cursor / Gemini CLI)…乘风视频剪辑 Skills用 Claude Code Skills 做的视频剪辑 Agent。中文侧最成型的一…OpenChatCut对话式视频剪辑器,本地优先。你说「第二条音轨第 8 秒加个故障转场」,它就去改那一刀…video-podcast-maker给编码 Agent 用的 skill:给一个主题,出一条 4K 带解说的讲解片。11…motion-skills动效技能索引:55 个技能分成 18 个安装包,覆盖短视频、数据动画、网页动效、3D…ComfyUI-ManagerComfyUI 的节点管理器:装节点、装模型、修依赖、查注册表。ComfyUI 生态…ComfyUI-WanVideoWrapper把 Wan 系列模型接进 ComfyUI 的节点包。社区里跑 Wan 的事实标准封装…ComfyUI 官方工作流模板ComfyUI 内置的那批官方工作流模板与子图蓝图的真身仓库。…waoowaoo把一部小说灌进去,自动拆角色、拆场景、出分镜,再合成整集短剧。中英双界面。…魔因漫创桌面端 AI 影视工具(Electron):剧本 → 角色 → 场景 → 导演 → …BigBanana AI Director一站式 AI 短剧 / 漫剧工作台,四阶段:剧本 → 视觉资产 → 分镜制作 → 导…ClipForge带货短视频专用的一站式工具:上传商品图,自动提炼卖点、写种草脚本、配音配字幕加背景乐…短视频工厂跨平台桌面应用:给提示词文本加分镜素材,自动剪出产品营销或泛内容短视频。集成文案生成…AI YouTube Shorts Generator把一条长视频切成一批排好序的竖屏短片:用语言模型找高光片段、用 Whisper 转写…Open AI UGC生成 UGC 风格的口播广告:用多个视频模型出真人感的 AI 演员念你的脚本。定位是…ViGenAiR把一条已有的视频广告用生成式 AI 重新剪成适配不同版位与时长的多条。…LiveTalking实时交互流式数字人引擎,音视频同步对话。支持 ernerf、musetalk、wav…Seedance 2.0 Prompt Skills给 Agent 装的 Seedance 2.0 提示词技能:讲输入约束、@ 引用语法…Drama Skills面向编剧与漫剧工作室的短剧创作流水线:十个技能把一个点子或一部长篇材料,一路做成分集…Seedance2 Storyboard Generator开源剧情剧本技能:把故事拆成分镜,并整合成 Seedance 2.0 认的结构化提示…AI Shortfilm Prompts一个 Claude Code 技能:把任意一个想法变成电影语言的、模型直接能用的视频…Awesome Seedance 2 Prompts整理好的 Seedance 2.0 视频提示词库,README 自述逾六千条,覆盖电…歸藏的提示词库中文 AI 圈里流传最广的个人提示词仓库之一,存放作者为各家模型撰写的提示词。…AI Visual Prompt Cookbook171 套结构化提示词风格、342 张预览;JSON 模板支持 v2.1 / v2.…PromptLensAI 视频提示词分析工具:丢进一条别人的视频,反推出它的提示词与创作脚本,并做画面分…Prompt Engineering Guide提示词工程的系统性指南:教程、论文、课程笔记与可运行的示例。不针对视频,讲的是提示词…蓝书 AI 视频工具包AI 视频提示词、技能与方法论工具包。2026-10-10 README 自述:60…
github README + GitHub API + LICENSE + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。