AI-Video-Factory README

The project's README from github.com/ersinkoc/AI-Video-Factory. As one markdown file: 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)

Searching Database…

What is this?It turns one topic into a finished, multilingual, animation-heavy YouTube video. Claude agents write the story and script, plan the shots and draw the art, and paid media APIs supply voice, images and clips.
Is it a library I embed, or an app I run?It is an app you run yourself, not a library: a topic-to-video pipeline with a web Studio where you see every step and can approve or reject results.
How do I get it running?Clone the repository and install dependencies with pnpm. The README excerpt does not show the exact setup commands, so follow the setup section in the repo before running it.
What accounts or APIs do I need?You need Claude access for the agents, plus paid media APIs for voice, images and video clips; Remotion renders the final cut. The provider choices are described in the Turkish docs/PROJEPLANI.md.
What style packs are available?There are 64 ready-made style packs, from flat explainer and film noir to ukiyo-e and synthwave, plus four 3D-look packs. In Automatic mode a cheap agent picks the pack that fits the topic.
What happens if a run fails halfway?Every stage is idempotent and saves after each sub-step, so a failed run resumes where it stopped instead of starting over.
How can I preview styles before choosing one?Run pnpm ys styles to list them. The new-episode form shows a gallery of the same character and room in each pack, and pnpm ys styles samples can draw missing samples for about $0.2–0.3 per pack.
What makes the 3D-look packs different?Their characters are real 3D figures built in code with three.js, so they can turn to profile while walking, and their rendering stays free.
Creator
ersinkoc
Size
10.9 MB
Stars
507
Age
20d
Commits · 90 Days