BeatDesign

io.github.erickkkyt由 GitHub 账号 erickkkyt 发布v0.2.1更新于 Oct 24, 2026

Local-first open-source AI media workbench with Canvas, video editor, Assets, and MCP tools.

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

BeatDesign 是本地优先的 AI 媒体工作台,其 MCP 工具让助手在浏览器中所见的同一图像与视频项目里工作。

可以做什么
发现并使用内置 Skill,管理 Project 与 Studio、Canvas、Editor 共享的 Assets,包括导入和生成媒体文件、查看生成历史。在无限画布上搭建和编辑图像、视频、音频、生成、时间线与文本节点工作流,支持分支与对比生成结果。通过内置 BeatAPI 提供方生成图像和视频,并执行标准或深度视频分析。以非破坏方式编辑时间线,包括片段、音频、可移动图像叠加层和带样式的 SRT 字幕,然后渲染权威 MP4 时间线并保持 Editor 打开以供审阅。
适用场景
当你希望编码助手驱动本地 AI 图像与视频项目时使用:在时间线上拼接片段、放置叠加层、调整字幕,或在浏览器中审阅的同一工作区内生成和分析媒体。
运行要求
作为本地进程运行于 macOS 或 Windows,需要 Node.js 22+、pnpm 10+ 和较新的 Chrome 浏览器;用 pnpm dev 启动工作区,用 pnpm mcp 启动 stdio MCP 服务器,用 pnpm dev:agent 启动 HTTP MCP 端点。仅在生成、分析媒体或使用 AI 重做时需要 BeatAPI API 密钥;本地导入、编辑、预览和导出无需密钥。
安装前请注意
BeatAPI API 密钥属于凭据,生成或分析可能消耗付费额度。助手的改动会写入浏览器所见的同一本地项目,因此对时间线、素材和字幕的编辑是真实生效的。选择本地文件不会上传,但生成或分析媒体会把内容发送给提供方。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BeatDesign,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[BeatDesign infinite Canvas and local video Editor]

[图片]

BeatDesign

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

English · 简体中文 · 日本語

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.

Latest release — v0.2.5 · October 2026

Available in GitHub Release v0.2.5 and @beatapi/[email protected]. WorkBuddy marketplace review and availability are tracked separately.

For an existing source checkout, stop BeatDesign, run git pull --ff-only, pnpm install --frozen-lockfile, pnpm db:push, then restart pnpm dev:agent (or your usual UI/MCP commands). Keep your local data directory; no reinstall or project reset is needed.

  • Project settings: edit names and descriptions, upload or select a cover, and reset to an automatic image or local video poster. A manual cover stays selected after later imports and generations. Open the settings icon on a project card or workspace header.
  • Consistent generation versions: Canvas previews and Take selection agree on the latest successful output; manual selections and concrete timeline Assets are preserved.
  • Faster project entry: choosing Canvas or Studio creates one project and opens it directly, with retry protection.
  • Reliable audio export: MCP timeline rendering preserves clip gain across sequential shots, with peak protection for overlapping audio.
  • 30 MCP tools: Agents can update project settings through the same revision-checked command path as the UI. Canvas undo/redo can save an intentionally empty canvas; Windows test portability and narrow-screen layout are improved.

Already available: tail-frame continuation, Canvas-to-Editor handoff, image overlays, styled SRT captions, browser-native MP4 export, and MCP timeline rendering. Browser export needs no system FFmpeg; MCP frame extraction needs ffmpeg, and MCP timeline rendering also needs ffprobe.

Change details · Project settings · Current scope and roadmap

Current source (unreleased) adds persistent Canvas groups and arrangement, Asset folders, exact-version Elements and reusable local workflow templates, with 38 MCP tools. These changes are not in the v0.2.5 npm package. Organization guide.

Two creative modes, one Project

Infinite Canvas

Drop in prompts, images, video, and audio. Connect nodes, branch ideas, compare generations, reuse outputs, and keep the full visual workflow inside one project.

Video Editor

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.

Why BeatDesign

  • Local by default. Projects, media, Canvas state, timelines, and generation history stay in your local workspace.
  • Canvas and Editor stay connected. A generated result becomes a reusable project Asset instead of disappearing inside one tool.
  • Bring your own Agent. Codex, Claude Code, Cursor, and other MCP hosts can inspect and update the same Project you see in the browser.
  • Bring your own generation access. BeatAPI is the built-in provider. Local importing, arranging, editing, previewing, and exporting do not require an API key.
  • Fork-friendly foundations. Provider adapters, project storage, and the command layer are explicit extension points.

From idea to finished video

text
Prompt or local media        ↓Infinite Canvas ─── connect, generate, branch, compare        ↓Shared Assets ───── images, video, audio, extracted clips        ↓Video Editor ────── trim, arrange, preview, export MP4        ↑Any MCP Agent ───── works in the same local Project

Quick start

Requirements include Node.js 22+, pnpm 10+, and a current Chrome browser on macOS or Windows.

bash
pnpm installpnpm db:pushpnpm dev

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.

Choose how to run BeatDesign

CommandStarts
pnpm devThe visual workspace
pnpm dev:agentThe visual workspace and local HTTP MCP endpoint
pnpm mcpThe stdio MCP server for coding Agents

Use BeatDesign with an Agent

Current source exposes 38 local MCP tools (v0.2.5 packages expose 30) 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.

Platform compatibility

Coding Agent / platformStatusQuick setup
Claude Code✅ SupportedPlugin or MCP config
Codex✅ SupportedPlugin setup
ZCode✅ SupportedMCP config
OpenCode✅ SupportedMCP config
Cursor✅ SupportedMCP config
Windsurf✅ SupportedMCP config
VS Code + GitHub Copilot✅ SupportedMCP config
Cline / Roo Code✅ SupportedMCP config
Qwen Code✅ SupportedMCP config
Gemini CLI✅ SupportedMCP config
Hermes Agent✅ SupportedMCP config
Kiro✅ SupportedMCP config
Trae✅ SupportedMCP config
WorkBuddy✅ SupportedConnector setup
QwenWork✅ SupportedHTTP connector
Doubao Work✅ SupportedHTTP connector

Open the full Agent integration guide →

What works today

  • Image and video generation plus Standard and Deep video analysis.
  • Image, video, audio, generation, timeline, and text nodes on the Canvas.
  • Project Assets shared across Studio, Canvas, Editor, and MCP.
  • Non-destructive timeline editing with image, video, audio, movable image overlays, and styled SRT caption tracks.
  • Local preview and browser-side H.264/AAC MP4 export with WebCodecs and Mediabunny.
  • English, Chinese, and Japanese interfaces.
  • Local stdio and Streamable HTTP MCP transports.

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 →

Project guides

License

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.

来源:README.md,提交 b94e4af

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.2.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分