标题:场记板 表情符号:🎬 SDK:docker 颜色从:灰色 颜色到:灰色 置顶:是 应用端口:3000 禁用嵌入:否 HF OAuth:否 标题:迷你 简短描述:🎬 场记板
简介
🎬 场记板是一个开源的AI故事可视化工具。
场记板一年前原型设计完成,它并非旨在替代传统视频编辑器或使用3D场景作为输入的现代AI编辑器。
场记板的理念是让任何人都能通过交互式、迭代式和直观的过程使用AI创建视频,无需外部工具、电影制作或AI工程技能。
在场记板中,你不直接编辑视频和音频文件序列,而是通过高级抽象概念(如角色、位置、天气、时代、风格等)来迭代你的故事(在AI助手的帮助下)。
为此,我还在开发导演模式,你可以将视频全屏显示,舒适地坐在导演椅(或沙发)上,对AI场务助理下达指令来制作你的电影。
公开Alpha测试版访问
场记板的公开实例目前托管在Hugging Face上,你可以在Clapper.app上试用
徽章
赏金赞助商
这些慷慨的赞助商为代码赏金提供资金:
想要贡献?
对于用户或公司
赞助特定功能
!! 注意:我们最初用于赏金的平台目前存在问题。我们正在寻找替代解决方案。!!
如果你希望赞助项目、帮助吸引新开发者或更快地推广特定功能,你可以为特定工单开放赏金(例如"修复音乐片段时长"、"添加Adobe Premiere Pro导出支持"、"完成.fbx集成"),开源社区成员将能够提交拉取请求来解决这些问题。
如果你提交(支付)或接受(赚取)赏金,请在GitHub线程和/或Discord上发布消息,以帮助大家协调。
我目前正在添加文档以帮助新开发者入门,这应该能帮助新人接受赏金任务。
对于开发者
许可证
场记板使用GPL v3许可证,详情请参阅许可证文件。这与ComfyUI或Blender等应用程序的许可类似。
安装
先决条件
作为先决条件,你需要安装git lfs(参见项目根目录的.gitattributes
文件):
git lfs install
你还需要安装Bun
场记板已在Node 20.15.1
版本上测试过。
为确保使用此版本,你可以使用NVM来激活它:
nvm install
nvm use
如果你发现场记板可以在更新的(稳定)Node版本上运行,或有更好的版本管理建议,请开启一个工单。
安装
安装依赖项。
--include=optional
是为了确保安装可选依赖项(与你的系统兼容的预构建本地模块)
bun i
你可以运行以下命令来构建应用程序,确保所有类型一致且设置正确:
npm run build
运行Web应用程序
然后运行实际的应用程序,在输入此命令后首次访问localhost:3000时,应用程序将进行编译,这可能需要一分钟(字面意思:"Compiled / in 52.6s (6372 modules)")
bun run dev
使用Electron运行应用程序
正在进行Electron构建。
仍有一些事情需要调试和解决,但如果你是开发者,可以尝试通过Electron启动场记板,如下所示:
cd packages/app
bun run electron:start
如果这对你不起作用(node-gyp、setuptools、distutils等问题),你可能需要运行:
python3 -m pip install --break-system-packages setuptools
你还可以通过输入以下命令为你的操作系统构建场记板:
cd packages/app
bun run electron:make
你可能会在最后看到一条用红色写的DeprecationWarning消息,但那只是一个警告,只需打开./out/make
检查构建是否成功。
代码约定
我设置了Prettier和ESLint,它们使用一些基本规则(如果你想提出新规则,可以提出)
测试
要运行所有测试(单元和端到端),请运行:
bun run test
这不是瞬时的:playwright一开始可能看起来什么都不做。
@jbilcke-hf正在努力添加更多测试,并将担任"QA工程师"的角色。
单元测试
注意:我刚刚添加了Vitest,所以目前只有几个测试。
要在不观察的情况下运行测试,请输入:
cd packages/app
bun run test:unit:ci
要在观察模式下运行测试,请输入:
cd packages/app
bun run test:unit:watch
端到端测试
注意:我刚刚添加了Playwright,但我们还没有真正的测试。
请注意,由于应用程序需要30~60秒的构建时间(取决于你计算机的速度),运行这些测试可能需要一些时间。
bun run test:e2e
更多Playwright命令:
bunx playwright test
运行端到端测试。
bunx playwright test --ui
启动交互式UI模式。
bunx playwright test --project=chromium
仅在桌面Chrome上运行测试。
bunx playwright test example
在特定文件中运行测试。
bunx playwright test --debug
在调试模式下运行测试。
bunx playwright codegen
使用Codegen自动生成测试。
我们建议你从以下命令开始:
`bunx playwright test`
架构
为方便起见,你可以在运行时通过在浏览器的JS控制台中输入useUI.getState(), useIO.getState()
等来访问和检查任何服务