agnes-video-generator

Open-source, self-hosted AI video generator — completely free. Text to multi-scene video with narration, subtitles, and digital anchor via Web UI, powered by Agnes AI.

Automatically checked · GitHub checked 2026-11-12

agnes-video-generator

Overview

🎬 Agnes Video Generator — Completely Free AI Video Generator

中文 GitHub Stars License Python Website Docker Hub npm Sonar Quality Gate Sonar Coverage

Agnes Video Generator — Free AI Video Generator

🌏 Mirror Notice / 镜像说明 This project is also mirrored on Gitee for faster access in mainland China. The GitHub repository is the primary home of this project — issues, PRs, and stars are managed there. 本项目在国内 Gitee 设有镜像仓库,便于国内访问加速;GitHub 为项目主仓库,Issue / PR / Star 均在 GitHub 提交。

Completely free AI video generator — Built on Agnes AI's free models, no subscription, no high-end GPU, no usage limits. Type in a text idea and automatically generate multi-scene AI videos with narration and subtitles. Supports text-to-video, image-to-video, keyframes animation, digital anchor, and more. All AI compute runs in the cloud — a regular laptop is all you need. Try it online →

"The solution is not to suppress AI, but to make it a more equitable capability, so that everyone knows how to create more with AI. This is a very important vision for our company — to make world-class AI belong to everyone. What we can do may be insignificant, but this vision is very long-term and enduring."

— Bruce Yang, Founder of Agnes AI

🌐 Official Website | 📝 Blog (中文) | 📝 Blog (English)

🖥️ Try it now — no install needed: Visit video.lichuanyang.top and experience Simple Video mode directly in your browser. Just enter a prompt and generate a free AI video instantly.

🚀 Three Ways to Use — All Completely Free

ProjectRun WhereFeaturesLink
Agnes Video Generator (this project)Download & run locallyMore powerful — TTS narration, auto subtitles, digital anchor, image-to-video, keyframes animation, manuscript-to-video, checkpoint resume & moreGitHub
FreeShortVideoStudioFully online, in the browserLightweight, zero install — no setup at all, features under active constructionvideo.lichuanyang.top/studio · GitHub
Agnes Video Generator — agent-readyDriven by an AI coding agentLeast effort, still completely free — install the standalone agnes-video skill: it installs the service, generates the video, delivers the file, debugs failures and can open a PR for a real defect. No credits, no subscription, no GPUSkill repository · Flint

🤖 Or Let an AI Agent Drive It

Install one skill, then describe the result you want. The agnes-video skill installs the service, makes the video, delivers the file and diagnoses failures — you never clone this repository, and the skill is useful on its own, not just as an add-on to this project. It is also the cheapest way to start: no subscription, no credit packs, no per-second billing, no GPU — just one free API key.

git clone https://github.com/lcy362/agnes-video-generator-skills.git
npx flint-skills-hub     # Sources → add the cloned directory (flint reads its skills/ subdirectory)

flint is a local-first, open-source skills manager: it deploys the skill into any agent directory (Claude Code, Cursor, Codex, TRAE and more) by symlink or copy, with no cloud, no account and no telemetry. It works on local sources only — it never clones anything for you — so you register the directory you just cloned.

Or copy it in by hand — no flint required, but you repeat it for every project and every new agent:

cp -R agnes-video-generator-skills/skills/agnes-video <project>/.agents/skills/   # any agent that reads .agents/skills

The skill installs the service too. It runs scripts/bootstrap.py install, which puts the service under ~/.agnes-video (override with AGNES_HOME), keeps its own virtualenv there, starts it on localhost:8765, and re-runs nothing on the next use. Config, workspace, outputs and logs live in that same data root.

Then ask for outcomes — no commands, no flags:

"Make a creative long video about the Voyager probes, with narration and subtitles."

"My task 4de1bcd26fda failed — find out why and tell me if it is worth fixing."

"Take my finished task, improve the storyboard prompts, and regenerate only the affected scenes."

One loop, five stages — and it stays in the same skill, so nothing is lost between them:

StageWhat it does
InstallBootstrap the service under ~/.agnes-video and verify it through the real endpoints
CreatePick the pipeline, take the key safely, submit the task, report progress
DeliverCopy the file to $AGNES_HOME/outputs/<task_id>/ and report path, duration, resolution
DiagnoseClassify a failure as configuration, upstream capacity, or a genuine defect
FixAfter you agree: fork, fix a small defect, run pre-flight, open a PR

Full guide: Let an AI Agent Operate This Project.

⭐ Support & Contribute

If you find this project useful, please star the GitHub repository ⭐ — your support helps more people discover this free and open-source AI video generator.

Bug reports and feature suggestions are welcome via GitHub Issues.

💝 Support the Developer

Agnes Video Generator is and will always remain completely free and open-source. There will be no paid plans, no premium features, and no subscription services — now or in the future.

If you find this project helpful, here are a few ways to support its continued development:

  • ⭐ Star on GitHub — Star the repository to help others discover this project.
  • 🪨 Star the author's new project Flint — a local-first AI skills manager for your Claude Code / Cursor / other agents. Centralize, tag and reuse the skills you keep building.
  • 🌐 Whitelist the official website — Turn off your ad blocker on video.lichuanyang.top and click on an ad if something catches your eye. A small gesture that makes a real difference.
  • 📢 Share your creations — Post videos made with Agnes Video Generator on social media (Douyin, YouTube, Xiaohongshu, etc.) and tag the project. More exposure means more users, more feedback, and a better tool for everyone.

🎥 Demo

Three clips from the most recent batch on the official showcase. Each one was generated from a single prompt in simple video mode — no editing, no compositing.

1. Cold Corridor — Dolly Back From an Extreme Closeup

Opens on an extreme facial close-up, then a real dolly-back to a head-and-shoulders frame in a cool grey corridor — pores, flyaway hair and the cobalt turtleneck all hold. 12s, landscape, 720P.

Cold Corridor — Demo

2. Tang Dynasty Night Sakura — Portrait

A Tang-dynasty high bun and hairpins under night cherry blossoms: petals drift past, lantern glow lands on the cheek, the camera slides slowly sideways. 6s, portrait, 720P.

Tang Dynasty Night Sakura — Demo

3. Red Studio — Perfume Commercial

A perfume spot in a red studio: the mist sprays, a profile and red lips in close-up, a slow push-in and clean commercial lighting. 10s, landscape, 720P.

Red Studio — Demo

Browse the full gallery: video.lichuanyang.top/showcase

Why Agnes Video Generator?

Making AI videos today has an absurdly high barrier. Overseas services like Runway and Pika charge monthly subscriptions of tens of dollars. Domestic platforms like Jimeng and Keling charge by the second once their free quotas run out. Want to run open-source models locally? A GPU capable of video generation easily costs over ten thousand RMB. For most people who want to try AI video creation, the door is essentially closed.

We believe what Bruce Yang said — AI should be a more equitable capability. World-class AI should belong to everyone, not just those who can afford the bill.

To be honest, Agnes's video model isn't perfect yet. The generated frames are sometimes unstable, and complex actions occasionally deform. But it is completely free with no usage limits, and it iterates fast. We choose to grow with it rather than wait for a "perfect" commercial solution. If you share this mindset, then this project is for you — all you need is a free Agnes AI API key and an ordinary computer that can run Python to start creating AI videos at zero cost.

Comparison: Agnes vs. Commercial AI Video Tools

FeatureAgnes Video GeneratorRunway Gen-3Pika 2.0OpenAI SoraKling 1.6
PriceFree$15–$95/month$10–$95/month$20+/month (limited)Free quota, then pay-per-second
Open Source✅ Yes (MIT)❌ No❌ No❌ No❌ No
Self-Hosted✅ Yes❌ No❌ No❌ No❌ No
Max Video Length20s per clip, unlimited scenes10s per clip10s per clip20s per clip10s per clip
Multi-Scene Pipeline✅ Built-in (Creative/Manuscript)❌ Manual editing❌ Manual editing❌ Manual editing❌ Manual editing
AI Narration (TTS)✅ Free, built-in❌ Third-party❌ Third-party❌ Not available❌ Not available
Auto Subtitles✅ Word-level SRT❌ Not available❌ Not available❌ Not available❌ Not available
Digital Anchor✅ Built-in❌ No❌ No❌ No❌ No
Resolution Options9:16 / 16:9 / 1:1MultipleMultipleMultipleMultiple
Image-to-Video✅ Yes✅ Yes✅ Yes✅ Image inputs✅ Yes
Keyframes Animation✅ Yes✅ Yes✅ Yes❌ Not available❌ Not available
Local GPU Required❌ No (cloud API)❌ No (cloud)❌ No (cloud)❌ No (cloud)❌ No (cloud)
WatermarkNo watermarkBuilt-in watermarkBuilt-in watermarkC2PA metadataBuilt-in watermark
Usage LimitNo limit (16 req/min rate limit)Billed by computeBilled by generationBilled by generationBilled by generation

⚙️ Configuration

Everything is configured through environment variables — no config file is required. To start from a documented template:

cp .env.example .env    # then edit AGNES_API_KEY inside

.env.example lists every supported variable with its default value: API key, multi-key rotation, rate limits, port, model overrides, and maintenance options.

Have more than one API key? Set AGNES_API_KEY, AGNES_API_KEY_2, AGNES_API_KEY_3 … (numbering must be contiguous). Rate-limit quotas scale with your key count, a 429 automatically rotates to the next key, and the concurrency limit scales along with it.

Full walkthrough: Getting Started → Configure API Key.

📚 Documentation

  • Features — Creation modes, the completely free AI model chain, AI narration & smart subtitles, flexible creative controls, production-grade reliability, and the multilingual Web UI.
  • Getting Started — Install and deploy in 4 ways: Manual (start.sh), Docker, npm (npx free-short-video), or AI-Agent assisted.
  • AI Agent Operations — How to drive this project with a coding agent: install the standalone agnes-video skill once, then ask for outcomes — it installs the service, generates videos, diagnoses failures and can open a PR for a real defect.
  • Usage Guide — Configure your API key, pick a video mode, resume from checkpoints, the three chaining modes, and logs & output layout.
  • Architecture — Project structure and tech stack.
  • API Reference — Full REST endpoint list (progress via polling, no WebSocket).
  • FAQ — Frequently asked questions.
  • About & License — Acknowledgments and the MIT license.

🌐 Related Projects

More projects by the same author:

  • Agnes Video Generator — Completely free AI video generator (this project).
  • FreeShortVideoStudio — Fully online, in-browser video studio.
  • Flint — Local-first AI skills manager: centralize, tag, deduplicate and deploy your Skills into any agent or project directory. If it helps you, a star is very welcome! ⭐

Keywords: free AI video generator, AI video generation tool, text to video AI, free AI video maker, AI video creator, open source video generator, Agnes AI, text-to-video, image-to-video, keyframes video, AI narration, auto subtitles, multi-scene video, zero cost AI video, no subscription AI video tool, digital anchor, self-hosted AI video generator, open source alternative to Runway