eduvids

Every frame above is drawn by code. eduvids plans the lesson, writes the narration, writes Manim scenes for each beat, renders them in a sandbox, and times the voice to the picture. You get back a landscape video or a vertical Short, with a thumbnail.

Free, no sign-in needed. Works in other languages too.

Run it yourself

You need Node (or Bun), the E2B CLI, and accounts for the services below.

git clone https://github.com/namanbnsl/eduvids
cd eduvids
bun install

Build the render sandbox once:

cd sandbox-templates/eduvids-render
npm install e2b
E2B_API_KEY=... npm run e2b:build:prod

Copy .env.example to .env and fill it in:

GOOGLE_GENERATIVE_AI_API_KEY_1	Google AI Studio — writes the lesson and the code. _2, _3 are optional spares.
E2B_API_KEY	E2B — renders the video
CONVEX_DEPLOYMENT, NEXT_PUBLIC_CONVEX_URL	Convex — chats and videos
QSTASH_*	Upstash — runs the render workflow
KV_*	Upstash Redis — job state
UPLOADTHING_*	UploadThing — stores finished videos
NEXT_PUBLIC_CLERK_*, CLERK_*	Clerk — accounts

Optional: DEEPGRAM_API_KEY or OPENROUTER_API_KEY for a better English voice (falls back to gTTS), PostHog for analytics, and the YouTube and X keys for auto-posting.

bun run dev

Open localhost:3000.

1. In Google Cloud Console, create an OAuth client of type Desktop app. That gives you GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.

2. Put them into helper/get_google_refresh_token.mjs, then run it and approve access for your channel:

   node helper/get_google_refresh_token.mjs
   

3. Copy the printed token into GOOGLE_REFRESH_TOKEN.

4. Set YOUTUBE_PRIVACY_STATUS to public, unlisted or private, and optionally YOUTUBE_PLAYLIST_ID.

Create an app in the X developer console and add its keys to .env.

How it looks, and why

The design notes live in docs/, each with before/after renders and the scripts to reproduce them:

• Visual storytelling — show the idea, not a slide about it
• Video quality — composition, labels, 3D
• Thumbnail layout
• Render performance

Contributing

Issues and pull requests are welcome. If a video came out wrong, open an issue with the prompt — that's the most useful bug report there is. See CONTRIBUTING.md for setup, tests and PR guidelines.

License

MIT