Skip to content

lcy362 /agnes-video-generator

Writes a narrated, subtitled multi-scene video from a text idea or long article
Video frameworkMITEnglish README
Stars
454
30 days
+5
Last push
3 days ago

About agnes-video-generator

Feed it a text idea or a long article, and it builds a multi-scene video. TTS narration (a computer voice reading your script) and word-level SRT subtitles come built in. It runs on your laptop, but the model work happens in the cloud, so no GPU is needed. You'll need a free Agnes AI API key, and the video model still makes unstable frames.

Best for: Video makers who want a free, self-hosted pipeline from script to narrated short without a local GPU.

What it does

  • Splits a prompt or a pasted article into scenes and renders one clip at a time
  • Adds free TTS narration and word-level SRT subtitles automatically
  • Makes text-to-video, image-to-video, keyframes animation and digital anchor clips
  • Offers three scene-chaining modes and resumes from a checkpoint after a stop
  • Exports 9:16, 16:9 or 1:1 clips up to 20s each, with unlimited scenes
  • Rotates extra API keys on a 429 and polls progress over a REST API

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Copy the template and add your key: cp .env.example .env, then edit AGNES_API_KEY
  2. 2
    Add more keys as AGNES_API_KEY_2, AGNES_API_KEY_3 … (numbering must be contiguous) to raise the rate limit
  3. 3
    Start it with start.sh, or run it with Docker or docker-compose
  4. 4
    Or run the packaged version: npx free-short-video
  5. 5
    Open the Web UI, pick a video mode, paste a prompt or manuscript, and generate

Models and languages

Models it works with

  • Agnes AI video model
  • Agnes AI TTS

Interface and docs

  • English
  • Chinese

Alternatives

Other video framework projects people compare with agnes-video-generator.

harry0703

MoneyPrinterTurbo

Writes a narrated short video from a topic: script, voiceover, footage, subtitles

Video framework
  • MiniMax H3
  • Seedance
  • Wan
  • +7
128k GitHub stars+127/30dyesterdayMIT

ATH-MaaS

Pixelle-Video

Type one topic and get a narrated short video: script, images, voice, music

Video framework
  • Wan 2.1
  • DashScope Wan
  • HappyHorse
  • +7
29k GitHub stars+16/30d3 months agoApache-2.0

tyxben

AI_novel

Desktop app that turns novel text or one idea into subtitled short videos

Video framework
  • Gemini
  • DeepSeek
  • OpenAI
  • +5
281 GitHub stars1 month agoMIT

hypit-ai

hypit

A language that lets your coding agent clone and re-run short videos

Video framework
  • Seedance 2 Mini 720p
  • GPT Image 2
  • WhisperX
  • +2
19k GitHub stars+151/30dyesterdayCustom license

Featured on OpenMicroDrama

Do you maintain agnes-video-generator? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/lcy362-agnes-video-generator)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 1, 2026. The repo doubles as a promo for the author's other projects: it asks for GitHub stars and an ad-blocker whitelist. We write these descriptions ourselves. The repo's own docs are the final word.