The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the BeatDesign listing page.
Your local Higgsfield alternative.
Build image and video workflows on an infinite Canvas, finish them in a browser-native Editor, and let any MCP-capable Agent work in the same Project.
Website · Quick start · MCP · Product status
BeatDesign is an independent, open-source, local-first workspace for AI image and video creation. It is built for people who want the connected creative flow of tools such as Higgsfield, with a workspace they can run, inspect, and extend on their own machine.
Drop in prompts, images, video, and audio. Connect nodes, branch ideas, compare generations, reuse outputs, and keep the full visual workflow inside one project.
Turn Canvas results into a local timeline. Trim, split, move, mix audio, place and transform image overlays, style SRT captions, create alternate AI Takes, preview, and export MP4 in the browser.
Studio provides a focused generation surface. Assets keeps every imported and generated file available across Canvas, Editor, and MCP.
Requirements include Node.js 22+, pnpm 10+, and a current Chrome browser on macOS or Windows.
Open http://127.0.0.1:3020.
Add your own BeatAPI API key only when you want to generate or analyze media, or use AI redo. Selecting a local file does not upload it to a provider.
| Command | Starts |
|---|---|
pnpm dev | The visual workspace |
pnpm dev:agent | The visual workspace and local HTTP MCP endpoint |
pnpm mcp | The stdio MCP server for coding Agents |
BeatDesign exposes 29 local MCP tools for Skills, Projects, Assets, Canvas, generation, and Editor operations, including built-in Skill discovery and authoritative MP4 timeline rendering. Agent changes use the same project services and become visible in the browser workspace.
After connecting your MCP host, you can ask:
Open my latest BeatDesign project, add these clips to a timeline, place the logo overlay, adjust the subtitles, and leave the Editor open for review.
| Coding Agent / platform | Status | Quick setup |
|---|---|---|
| Claude Code | ✅ Supported | Plugin or MCP config |
| Codex | ✅ Supported | Plugin setup |
| ZCode | ✅ Supported | MCP config |
| OpenCode | ✅ Supported | MCP config |
| Cursor | ✅ Supported | MCP config |
| Windsurf | ✅ Supported | MCP config |
| VS Code + GitHub Copilot | ✅ Supported | MCP config |
| Cline / Roo Code | ✅ Supported | MCP config |
| Qwen Code | ✅ Supported | MCP config |
| Gemini CLI | ✅ Supported | MCP config |
| Hermes Agent | ✅ Supported | MCP config |
| Kiro | ✅ Supported | MCP config |
| Trae | ✅ Supported | MCP config |
| WorkBuddy | ✅ Supported | Connector setup |
| QwenWork | ✅ Supported | HTTP connector |
| Doubao Work | ✅ Supported | HTTP connector |
Open the full Agent integration guide →
BeatDesign currently focuses on local, short-form creative workflows. Hosted collaboration, multiple named timelines, advanced transitions, speed controls, waveforms, and desktop packaging remain outside the current release.
See the complete shipped and planned scope →
BeatDesign is licensed under Apache License 2.0. BeatAPI and BeatDesign trademarks, third-party model access, and bundled third-party components remain subject to their respective terms. See third-party notices and trademark policy.