Archon 工作流程，将任意网址转成一段短的有声 Remotion 视频——带语音，带可选音效/音乐，转为 mp4，存档于 repo。

它的作用

通过 $ARGUMENTS 传递模式 +（URL 或提示符）：

• "" / "hn" — 自动选择今日头条黑客新闻报道
• "article " —— 文章解说视频
• "marketing " — 产品网站推介视频
• "idea " — 用通俗英语描述主题，无需网址

每次运行都会在src/ /下放置一个新作品，并将mp4渲染成./videos/ - /。在仓库中打开的Studio会在一个侧边栏显示所有过去的视频。

---

快速开始——让你的编码代理来设置

最简单的方法：让你的编码代理帮你设置。 这个 README 是为任何代理都能端到端读取的，将仓库恢复到可运行状态，无需你手动执行安装命令。

1. 在这个仓库中打开你的编码代理。
2. 告诉它：“读取README.md并设置这个仓库，这样我才能运行Remotion视频工作流程。”
3. 当系统询问你的TTS提供商（Cartesia或ElevenLabs）时，请用你有的密钥回答。代理会创建.archon/.env并填写正确的变量。

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.