AI-Video-Factory README

项目的 README,来自 github.com/ersinkoc/AI-Video-Factory。合并为一个 markdown 文件:README.md。

AI Video Factory

English · Türkçe

License: MIT Release

AI Video Factory 0.6.0 — 64 styles, one video factory.

Turn a topic into a narrated, animated YouTube video. Claude agents write the story and script, plan shots, design vector art and review the result. Media providers supply voice, images and clips; Remotion renders the final cut. The web Studio keeps the process visible and puts approvals in your hands.

Documentation · Getting started · Studio guide · CLI guide · Changelog

What you can make

The episode budget caps paid image, voice and video APIs. Claude agent usage is tracked separately and can exceed that cap. See Production features for the details.

Quick start

You need Node.js 24+, pnpm 11, FFmpeg, and either a signed-in Claude Code installation or an ANTHROPIC_API_KEY. Add media-provider keys for the voice, image and video services you want to use. Docker is optional.

git clone https://github.com/ersinkoc/AI-Video-Factory.git
cd AI-Video-Factory
pnpm install
cp .env.example .env

In PowerShell, use Copy-Item .env.example .env for the last step. Fill in your keys in .env; providers with empty keys are disabled. Then start the Studio:

pnpm studio

Open http://localhost:3100, create an episode and review its script and concept before production. For smooth in-browser episode playback, use pnpm studio:build followed by pnpm studio:start.

To inspect your setup or try a local render without paid API calls:

pnpm ys doctor
pnpm ys render-demo

The demo pauses for preview approval; follow the demo steps to finish rendering.

Assets, the cost ledger and episodes are stored under .data by default. The Studio has no login and binds to 127.0.0.1; keep network access limited to people you trust. See Getting started for configuration and Studio access for network setup.

Make an episode from the CLI

pnpm ys episode new --topic "Ottoman coffeehouse bans" --lang en --minutes 3 --motion vector --budget 5 --manual

Use the returned episode ID:

pnpm ys episode run <id>
pnpm ys episode show <id>

--manual stops at approval gates. Generation uses your configured Claude account and media providers. The CLI guide covers approvals, options, retries and character reuse.

Documentation

I want to… Guide
Install, configure or update Getting started
Create and revise episodes in the browser Studio
Run production from the terminal CLI
Explore styles, animation and production behavior Production features
Find editing, source and quality-review tools Documentation index
Work on the codebase or releases Development

Architecture decisions and planned work are in the project plan (Turkish). Release history is in the changelog.

Sponsor

WrongStack — an open-source AI coding agent with persistent project memory. Website · GitHub

License

MIT © 2026 Ersin KOÇ. Third-party components, generated media and reference assets retain their own terms; see the Remotion license, your media providers' terms and each asset's source license.

AI-Video-Factory (ersinkoc/AI-Video-Factory)

正在搜索数据库…

这是什么?它能把一个主题变成一部完整的、多语言、大量使用动画的 YouTube 视频。Claude 智能体负责撰写故事和脚本、规划镜头并绘制画面,付费的媒体 API 则提供配音、图片和视频片段。
这是我要嵌入的库,还是我要运行的应用?它是一个你自己运行的应用,而不是库:这是一条从主题到视频的流水线,附带一个网页版 Studio,你可以看到每一步,并批准或拒绝结果。
怎么把它跑起来?克隆仓库,然后用 pnpm 安装依赖。README 摘录中没有列出具体的安装命令,运行前请先按仓库里的安装说明操作。
我需要哪些账号或 API?你需要有 Claude 的访问权限供智能体使用,以及用于配音、图片和视频片段的付费媒体 API;最终成片由 Remotion 渲染。服务商的选择说明见土耳其语文档 docs/PROJEPLANI.md。
有哪些风格包可以选?共有 64 个现成的风格包,从扁平解说风、黑色电影风到浮世绘和合成波,另外还有四个 3D 质感的风格包。在自动模式下,一个低成本智能体会为主题挑选合适的风格包。
如果运行到一半失败了怎么办?每个阶段都可以重复执行且结果不变,并且每完成一个子步骤就会保存一次,所以失败的运行会从中断处接着做,而不必从头开始。
选择之前,怎么预览风格?运行 pnpm ys styles 可以列出所有风格。新建剧集的表单会展示每个风格包中同一角色和房间的图库;如果缺少样图,运行 pnpm ys styles samples 可以为每个风格包生成样图,每个风格包约花费 $0.2–0.3。
3D 质感的风格包有什么不同?它们的角色是用 three.js 在代码中构建的真实三维模型,因此走路时可以转向侧面,而且渲染本身不额外收费。
作者
ersinkoc
大小
10.9 MB
星标
507
时长
20天
提交 · 90 天