remotion-idea-to-video

Archon workflow that turns any URL into a short voiced Remotion video — voiced, with optional SFX/music, rendered to mp4, archived in-repo.

What it does

Pass a mode + (URL or prompt) via $ARGUMENTS:

• "" / "hn" — auto-pick today’s top Hacker News story
• "article " — explainer video from an article
• "marketing " — pitch video for a product site
• "idea " — describe a topic in plain English, no URL needed

Each run drops a new composition under src// and renders an mp4 into ./videos/-/. Studio opened against the repo shows every past video in one sidebar.

---

Quick start — let your coding agent set this up

Easiest path: have your coding agent do the setup for you. This README is written so any agent can read it end-to-end and bring the repo to a runnable state without you running install commands by hand.

1. Open your coding agent inside this repo.
2. Tell it: “Read README.md and set up this repo so I can run the Remotion video workflow.”
3. When it asks about your TTS provider (Cartesia or ElevenLabs), answer with whichever you have a key for. The agent will create .archon/.env and fill in the right variables.
4. When the agent reports everything verified, run the workflow (see Run).

Which coding agent?

We’ve tested with Claude Code, and that’s the recommended starting point. Archon also supports Codex and Pi — set DEFAULT_AI_ASSISTANT=claude|codex|pi in .archon/.env. The setup steps below assume Claude Code; swap the claude install command for the equivalent assistant CLI if you’re using something else.

Note for the coding agent reading this: this README is the single source of truth for setup. Walk through Prerequisites checklist → Verify what’s already installed → Install (per requirement) → Run in order. Do not guess the TTS provider — ask the user which key they have (Cartesia or ElevenLabs) before writing .archon/.env. Do not skip steps. Do not invent commands not in this file.

---

Prerequisites checklist

Six things must be present. None of them are optional.