📈 GH Trending Explorer 🎲 Surprise me

← all repos

sitor-ai / frametell

git clone https://github.com/sitor-ai/frametell.git v0.7.1 · 4d ago

Frametell: turn your ideas and material into vivid explainer videos with an AI director agent. Local-first, any model.

—
stars, 24h
—
stars, 7 days
+342
stars, 30 days · #780
342
★ total
67
forks · 6 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageTypeScript
LicenseAGPL-3.0
Created2026-10-10 (10d ago)
Last push1d ago
Watchers1
OwnerOrganization

GitHub topics

Links

README excerpt
English · 简体中文 
**Frametell** (帧言, *zhēn yán*) turns your ideas and your material into vivid explainer videos with pages that move. One sentence is enough to start ("explain the uncertainty principle"), or you can hand it notes, documents, PDFs, slides and images. A director agent first drafts a storyboard for you to sign off on. Then it writes the narration, voices it, draws each page and checks its own work. You get a 1080p video, with subtitles and publishing notes.
It's built for knowledge creators who explain history, science, technology, investing, psychology or books, and who'd rather tell the story than learn video editing.
## See it
https://github.com/user-attachments/assets/99dd4dc5-2ed4-421d-bf4d-697acd553b59
One run in the desktop app, condensed to a minute: a question, a storyboard to sign off, narration, voice, five pages and the finished film (72 s, made in 12 min 52 s for $1.59).
Two films Frametell made end to end in English: storyboard, narration, an ElevenLabs voice, every page and the render. Click a picture to watch (with sound).
 Why is the sky blue? · 87 s, chalkboard . Made from one sentence (“Why is the sky blue, and why are sunsets red?”) with Gemini. 
 Why starting early matters · 72 s, warm-story . Compound interest, from one sentence, with Gemini. 
Frametell makes Chinese films just as well; see the Chinese README for two of them.
## Why Frametell
- **You approve the plan first.** Nothing gets drawn until you've signed off on the storyboard. If a page is wrong, point at it and say what to change.
- **You can watch it work.** The agent says what it's doing and why, and the cost and time spent are on screen at every step.
- **Stable results, fewer tokens.** The agent drives a mature video engine with styles, components, camera moves and quality checks. It doesn't generate video from scratch.
- **Runs locally, with any model.** Your materials and API keys stay on your computer. It works with Anthropic, OpenAI, Google, DeepSeek, OpenRouter and other providers, or any OpenAI- or Anthropic-compatible endpoint.
## How it works
1. **Idea or material.** Type what you want to explain, as one sentence or a page of thoughts, or drop in a document, PDF, slide deck, images or Markdown. Either is enough, and you can give it both.
2. **Storyboard.** The director turns your idea or material into pages and story beats, and you approve or edit them.
3. **Narration and voice.** It writes the script and voices it with ElevenLabs (or Volcengine TTS for Chinese).
4. **Pages.** It draws every page in the style you chose and checks each one with lint and screenshots.
5. **Film.** It runs a final check on the full video, then renders a 1080p MP4 with subtitles.
Built-in styles: `warm-story`, `study`, `chalkboard`, `whiteboard`, `tech-dark`.
## Get started
### Download the app
**macOS on Apple Silicon:** download the `.dmg` from the latest release, open it and drag Frametell into Applications. The app is signed and notarized by Apple. You also