Enables cloud-based voiceover generation with realistic narration.
Offers cloud-based copywriting for generating brand scripts and storyboards.
Supplies city background images for the brand film.
Supplies city background images for the brand film.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@WayCast turn https://stripe.com into a brand film"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Turn any company's URL into a polished vertical brand‑film — script, voiceover, city backgrounds, final MP4 — without opening an editor.
Open‑source · self‑hosted · local‑first. No avatars, no stock‑footage clichés — clean institutional motion‑graphics. The AI agent driving it is the writer, so it runs with zero cloud keys if you want.
中文说明 → README.zh.md · MIT OR Apache‑2.0 · Node ≥ 22 · pre‑alpha
npx waycastai doctor # what your machine can do
npx waycastai make https://stripe.com --reuse-bg wjdigital # URL → brand package in ./brands/
npx waycastai render <slug> --quality standard # → ./output/*.mp4Everything lands in your folder. Prefer a UI? npx waycastai console → http://127.0.0.1:4178.
Related MCP server: ai-video-mcp
A 1080×1920, 8‑shot institutional brand film — cover → who‑we‑are → what‑we‑do → why → how → who‑it‑powers → beliefs → CTA — data‑driven from a reusable block library, EN + ZH, real‑voice narration, per‑shot city backgrounds.
Most "URL → video" tools are paid SaaS, or wrap a cloud API behind talking‑head avatars. WayCast is the opposite end:
WayCast | |
Agent‑native | Driven by Claude Code / any agent via MCP — the agent writes the storyboard itself, so good copy needs no LLM key |
Local‑first | Renders locally; bundled local TTS (Kokoro EN / CosyVoice ZH same‑voice clone, Apache‑2.0) — or BYO cloud key |
Zero‑dependency | Pure Node + ffmpeg. No framework lock‑in |
Style | Clean text‑motion brand films — no avatars, no random stock B‑roll |
Bilingual | English + 简体中文 first‑class (most OSS video tools are EN‑only) |
Yours | Self‑hosted, dual‑licensed, keys stay in your |
CLI / npx — npx waycastai make <url> → render.
Any coding agent — clone, point Claude Code at it; it reads CLAUDE.md and authors + renders the film itself. See docs/agent-usage.md.
MCP — claude mcp add waycast -- npx waycastai mcp → 7 tools (waycast_scrape / write_brand / render / …). See docs/mcp.md.
URL ─▶ scrape ─▶ brief (+brand color) ─▶ script (EN/ZH copy) ─▶ pick city images
▼
brand package (brand.json + storyboard.json + vo.json + bg)
▼
local TTS ─▶ retime to narration ─▶ render (hyperframes) ─▶ MP4Every stage has a keyless local/deterministic fallback and an optional BYO‑key upgrade. Anti‑fabrication is enforced — the copy only uses facts from the site.
Capability | Local (offline) | Cloud (BYO‑key) |
Voiceover (required, pick one) | Kokoro (EN) / CosyVoice (ZH) | OpenAI / ElevenLabs / Azure |
Copywriting | deterministic draft or the driving agent | Anthropic / OpenAI |
City images |
| Pexels / Unsplash |
Keys go in .env (.env.example). npx waycastai doctor shows what's ready. Full setup: docs/install.md.
Core pipeline (URL → standard MP4) is verified end‑to‑end via the local path. Cloud LLM/TTS/image adapters are implemented but not yet live‑tested; a one‑click Docker image for the local models is WIP; Windows is untested (use WSL). It's a self‑hosted dev tool, not a turnkey consumer app. Changelog: CHANGELOG.md.
Dual‑licensed MIT OR Apache‑2.0 — your choice. Third‑party components (local TTS models, fonts, CC‑BY sample images, GSAP via CDN) in NOTICE.
Early days — issues and ideas welcome. See CONTRIBUTING.md. If it's useful, a ⭐ helps others find it.
This server cannot be deployed
Create branded vertical video ads from ecommerce product URLs or product photos.
Turn URLs, recordings, docs, assets, or ideas into launch films, demo recordings, and decks.
Build, run, schedule, and publish AI video pipelines to YouTube and TikTok from any MCP client.
AI video producer: directs your idea or script into a finished, fact-checked video. MCP-native.
