What is BeatDesign?
BeatDesign, from BeatAPI, is a browser workspace you run on your own machine: an infinite canvas for prompts, images, video and audio, a timeline editor for trimming, overlays, styled SRT captions and MP4 export, and a shared asset library. Its MCP server works on the same project and SQLite database as the browser, so changes an agent makes show up in the open tab. Image and video generation goes through BeatAPI with your own API key; importing, editing and exporting need no key.
The repo is Apache-2.0, written in TypeScript, had about 348 stars on 11 November 2026 and released v0.2.5 on 21 October 2026, with the last commit on 4 November. It runs on macOS or Windows with Node.js 22+, pnpm and a current Chrome.
How to install BeatDesign
git clone https://github.com/BeatAPI/BeatDesign.git && pnpm install && pnpm db:push && pnpm mcpIs BeatDesign worth it?
BeatDesign's MCP server is better engineered than its star count suggests. The v0.2.5 package exposes 30 tools and current source 38, across projects, assets, canvas, generation and the editor, and every write goes through the same command layer as the browser with stable IDs, revision checks and idempotency keys. The server never replaces a whole canvas or timeline, so an agent that loses a race replays one operation instead of wiping your work, and a generation request writes a visible pending card before it contacts the paid provider.
For an agent, the editor tools are the reason to install it. It can lay clips on a timeline, place and move image overlays, tune caption cues and render the saved timeline to an MP4 with ffmpeg and ffprobe, then hand you a link to the exact tab for review. Hosted rivals such as Higgsfield's server generate media; this one also assembles it.
The catch: generation is wired to BeatAPI by default, with its upstream URL fixed, and other providers mean writing an adapter in a fork. BeatAPI is pay-as-you-go, with images from $0.012 and video billed mostly per second, and its site does not name the company behind it. Hosted collaboration, multiple named timelines, transitions, speed controls and a desktop package are not built yet, and the bundled skill catalogue is deliberately empty until a skill passes the project's own tests.
On security, the app is single-user with no authentication. The workspace serves 127.0.0.1:3020 and the optional HTTP MCP endpoint 127.0.0.1:3031, both on loopback, and production rejects non-local Host headers; setting BEATDESIGN_MCP_TOKEN adds a bearer token. API keys are encrypted in the local SQLite file. Exposing either port beyond your machine would hand anyone your projects and your BeatAPI balance.
Where it earns its place
A social media manager at a 20-person consumer brand
Turn six product clips and a logo into a captioned 30-second ad
Import the clips, ask the agent to build the timeline, place the logo overlay and import the SRT, then review in the Editor tab it opens. Free when no generation is involved.
A solo YouTuber storyboarding a short animated sequence
Branch image ideas on a canvas, then extend the chosen shot into video
Generate stills on the canvas, continue from the tail frame of a clip, and pay BeatAPI per image or per second of video for each generation you confirm.
A developer building a video pipeline for an in-house agent
Script repeatable edits and renders without a cloud editor
Run pnpm mcp, drive bdesign_editor_edit and bdesign_editor_render from the agent, and keep every project in the local database and data/project-assets folder.
Before you commit
- Setup
- Clone the repo, pnpm install, pnpm db:push, then pnpm dev for the workspace or pnpm mcp for the stdio server; configs ship for Claude Code, Codex, Cursor, VS Code Copilot, Gemini CLI and more than ten other hosts.
- Integrations
- 30 tools in v0.2.5 and 38 in current source, including bdesign_canvas_apply, bdesign_generation_submit, bdesign_editor_edit and bdesign_editor_render, plus read-only skill resources at beatdesign://skills. Stdio and Streamable HTTP transports.
- Data and privacy
- Projects, media and history stay in a local SQLite database and folder. The agent can import local files you point it to, edit and render projects; generation references are uploaded to BeatAPI only when you submit a request. Provider keys are encrypted locally. No authentication on the workspace, so it must stay on loopback.
- Cost at scale
- Free locally. BeatAPI lists images from $0.012 (Nano Banana 2.1 at 1K) to $0.05 (Nano Banana Pro); video is billed mostly per second and Veo 3.1 per video. No free credits are published.
- Limits
- macOS and Windows with Chrome only; short-form work; no hosted collaboration. Two open issues on 11 November 2026.
What’s good
- Agent edits through revision-checked, idempotent commands
- Renders the saved timeline to MP4 from MCP
- Local editing and export need no API key
- Loopback-only by default, with an optional bearer token
What’s not
- Generation tied to BeatAPI unless you fork
- Clone-and-build install; no desktop package
- No transitions, speed controls or multiple timelines yet
- MCP rendering needs ffmpeg and ffprobe on PATH
Best for
Creators and small marketing teams making short videos who want an agent to assemble and caption clips in a workspace that keeps media on their own machine.
BeatDesign alternatives
BeatDesign: common questions
- Is BeatDesign worth it?
- A careful local video workbench an agent can genuinely edit in, held back by its youth and a default tie to one paid provider. We rate it 3.5 out of 5.
- How much does BeatDesign cost?
- Free and open source (Apache-2.0). Generation is pay-as-you-go on BeatAPI with no subscription; images start at $0.012 each on its price list.
- What are the downsides of BeatDesign?
- Generation tied to BeatAPI unless you fork; clone-and-build install; no desktop package; no transitions, speed controls or multiple timelines yet; mCP rendering needs ffmpeg and ffprobe on PATH.
- Who is BeatDesign best for?
- Creators and small marketing teams making short videos who want an agent to assemble and caption clips in a workspace that keeps media on their own machine.
- How much does BeatDesign cost for a team or in production?
- Free locally. BeatAPI lists images from $0.012 (Nano Banana 2.1 at 1K) to $0.05 (Nano Banana Pro); video is billed mostly per second and Veo 3.1 per video. No free credits are published.
- Is BeatDesign safe for company data?
- Projects, media and history stay in a local SQLite database and folder. The agent can import local files you point it to, edit and render projects; generation references are uploaded to BeatAPI only when you submit a request. Provider keys are encrypted locally. No authentication on the workspace, so it must stay on loopback.
- What are the best BeatDesign alternatives?
- The closest alternatives we have reviewed are Higgsfield MCP and MCP for Blender.
Answers checked Nov 11, 2026.