claudeers.
// Automation & Workflows

video-factory

An AI video studio your coding agent installs and runs: UGC ads, micro-dramas, sitcoms, launch films, fantasy shorts, hour-long meditations. Claude Code / Co…

Actively maintained
100/100
last commit 19 days ago
last release 19 days ago
releases 21
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up video-factory (git-clone project) into my current project.
Found on https://claudeers.com/video-factory
Repo: https://github.com/LordVayron/video-factory
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/LordVayron/video-factory
Category: automation. Platforms: api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/LordVayron/video-factory

// compatibility

Platformsapi, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Video Factory: the AI video studio your agent runs

An AI video studio that your coding agent installs and runs for you.
UGC ads, micro-drama series, sitcoms, fantasy shorts, hour-long meditations and more,
written and directed by Claude Code or Codex, rendered on APIMart, Kie.ai and ElevenLabs.


Website: https://videofactory-tv.vercel.app · watch the pilot episode made with it.

Install it in one message

Open Claude Code or Codex and paste:

Install https://github.com/LordVayron/video-factory and set it up for me.

Your agent clones the repo, installs everything it needs, checks your machine, and then asks you five quick questions: what you want to create, where you'll publish it, the language and tone, whether you have your own brand or characters, and your budget per video. It creates your profile and your first project, and you're ready to make your first video.

Onboarding conversation

Instalación en español: abre Claude Code o Codex y escribe "Instala https://github.com/LordVayron/video-factory y configúralo para mí". Tu agente instala todo, te hace 5 preguntas y deja listo tu primer proyecto.

You need APIMart or Kie.ai for images and video (both is best: the engine compares their live prices and sends every job to the cheaper one, APIMart first; Kie also makes the music), and ElevenLabs (voices). You paste the keys into a local .env file yourself; they never leave your machine.

What you can make

FormatLengthTypical costHow
UGC product ads15–30 s, 9:16$1–3creator-style review with your product shots
Micro-drama series (vertical novelas)60–120 s episodes$2–5 per episodelocked cast, cliffhangers, captions
Sitcoms and comedy series40–60 s episodes$2–5 per episodewriters' room, radio cut, laugh track, series intro
Fantasy shorts30–90 s$2–6epic or cozy, style-locked
Meditation, sleep and ambient10 min – 3 h, 16:9about $2 for 30 minseamless looping scenes, music bed, voice-over with real pauses, plus an MP3
AI influencer / clone me15–60 s$1–4your own face and voice only, with consent
Product launch films30–35 s, 16:9$4–8from your landing page: interview, three concepts, one continuous story in storybook, anime, photoreal or your own style, narration, composited brand and CTA
Anime, cinematic, podcast clips15–60 s$1–5per-vertical playbooks

Each format has a playbook (a "vertical DNA" file) with what makes it work, how to write it, pacing numbers, and a QC checklist. To make a different format, open a new conversation in the folder and say what you want: "make a 20-minute sleep meditation", "start a TikTok novela about a hidden inheritance", "UGC ad for my coffee brand".

How it works

flowchart LR
  U([You]) -- idea --> A[Your agent<br/>writes the script]
  A -- gate 1: script --> U
  A --> R[Radio cut<br/>voices + timing]
  R --> S[Storyboards<br/>GPT Image 2.5]
  S --> B[Production Book<br/>prompts + cost]
  B -- gate 2: budget --> U
  U -- approve = budget locked --> F[Film<br/>Seedance, one generation per scene]
  F --> Q[Continuity + QC<br/>vision judge]
  Q --> E[Auto edit<br/>cut, voices, captions, music]
  E --> V([Your video])
  • One enforced path, every format. Every video starts with seven quick questions (single or series, format, idea or from scratch, platform, cast, budget, references) and moves step by step: concept, script, cast, storyboard, Production Book, film, edit, final QC, delivery. The engine refuses a step out of order, and a Claude Code hook stops one-off scripts and undelivered files.
  • You approve the creative gates: concept, script, cast and the Production Book (the budget), in your own words. Nothing is spent on video before that.
  • The budget is locked in code. Once you approve the Production Book, the engine refuses any job that would go past it. Extra spend needs your explicit yes.
  • Audio first. A "radio cut" of the voices sets every shot's length before any picture is paid for, so pacing is right on the first take.
  • One generation per scene with all its shots, in the cheapest model that keeps quality (Seedance 2 Mini by default).
  • Automatic QC: every take is checked for identity (faces and marks like freckles or glasses, against a locked face), jumps inside the shot, dialogue, positions, physics, light and geography; the final is checked across every cut before a delivery receipt is issued.

For long-form: meditation, sleep and ambient

A 30-minute guided meditation costs about $2, because the picture loops:

  • 3–6 scenes, each one a seamless loop: a GPT Image 2.5 still animated by Seedance with the first frame equal to the last (or a free slow zoom).
  • A Suno music bed that ducks gently under an ElevenLabs voice-over, with pauses you control segment by segment.
  • 1080p for YouTube plus an MP3 for Spotify and meditation apps, a contact sheet, and a loudness and dead-air check.
  • Only the loop units and transitions are encoded; the rest is stream-copied, so 30 minutes of 1080p renders in about 5 minutes.

Manual install

Prefer to do it yourself? See docs/INSTALL.md. In short:

git clone https://github.com/LordVayron/video-factory.git
cd video-factory && npm run setup

Then copy .env.example to .env, paste your keys, run npm run doctor:online, open your agent in the folder and say "onboarding".

Repository layout

.claude/skills/   the skills your agent follows (studio, onboarding, story-architect, cinematographer, cast, format-series, format-longform)
  studio/references/   the knowledge base: vertical playbooks, QC rubric, styles, comedy and story craft
engine/           Node CLIs that call APIMart, Kie.ai, ElevenLabs and ffmpeg (generation, budget lock, edit, QC)
bible/styles/     style sheets (UGC phone, hyperreal, anime, podcast, retro sitcom, template)
templates/        starting points: creator profile, character, set, series
bible/, series/, projects/   your own characters, shows and videos (gitignored, they stay on your machine)
AGENTS.md         house rules for any agent (CLAUDE.md imports it)
SETUP.md          step-by-step install instructions for agents

Commands

CommandWhat it does
npm run doctorChecks tools, Python packages, keys and the repo
npm run doctor:onlineSame, plus your Kie credits and ElevenLabs key
npm testOffline checks and a secret scan (no keys, no paid calls; GitHub runs them on every PR)
npm run pricesLive prices from APIMart and Kie, and which one runs each model
npm run creditsYour APIMart and Kie balances

Engine CLIs (node engine/<tool>.mjs) are documented in docs/ARCHITECTURE.md.

Responsible use

Make original characters and stories. Don't generate real people other than yourself (with your own photos and voice) unless they authorized it (the engine records your statement), copyrighted characters, or brands you don't own. Follow each platform's rules for AI-generated content and label it where required. Your Kie.ai and ElevenLabs usage is subject to their terms.

Documentation

MIT licensed. Not affiliated with Anthropic, OpenAI, APIMart, Kie.ai, ElevenLabs or Higgsfield.

// faq

What is video-factory?

An AI video studio your coding agent installs and runs: UGC ads, micro-dramas, sitcoms, launch films, fantasy shorts, hour-long meditations. Claude Code / Codex + APIMart + Kie.ai + ElevenLabs.. It is open-source on GitHub.

Is video-factory free to use?

video-factory is open-source under the MIT license, so it is free to use.

What category does video-factory belong to?

video-factory is listed under automation in the Claudeers registry of Claude-compatible tools.

35 views
★ 62 stars
unclaimed
updated 27 days ago

// embed badge

video-factory on Claudeers
[![Claudeers](https://claudeers.com/api/badge/video-factory.svg)](https://claudeers.com/video-factory)

// retro hit counter

video-factory hit counter
[![Hits](https://claudeers.com/api/counter/video-factory.svg)](https://claudeers.com/video-factory)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 260,254◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how video-factory connects across the ecosystem