{
  "markdown": "<p align=\"center\">\n  <img src=\"./docs/assets/beatdesign-readme-cover-v3.jpg\" alt=\"BeatDesign infinite Canvas and local video Editor\" width=\"100%\" />\n</p>\n\n<h1 align=\"center\">BeatDesign</h1>\n\n<p align=\"center\">\n  <strong>Your local Higgsfield alternative.</strong><br />\n  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.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://design.beatapi.io\">Website</a> ·\n  <a href=\"#quick-start\">Quick start</a> ·\n  <a href=\"#use-beatdesign-with-an-agent\">MCP</a> ·\n  <a href=\"./docs/PRODUCT_PLAN_AND_STATUS.md\">Product status</a>\n</p>\n\n<p align=\"center\">\n  <strong>English</strong> ·\n  <a href=\"./README.zh-CN.md\">简体中文</a> ·\n  <a href=\"./README.ja.md\">日本語</a>\n</p>\n\nBeatDesign 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.\n\n## Two creative modes, one Project\n\n### Infinite Canvas\n\nDrop in prompts, images, video, and audio. Connect nodes, branch ideas, compare generations, reuse outputs, and keep the full visual workflow inside one project.\n\n### Video Editor\n\nTurn 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.\n\nStudio provides a focused generation surface. Assets keeps every imported and generated file available across Canvas, Editor, and MCP.\n\n## Why BeatDesign\n\n- **Local by default.** Projects, media, Canvas state, timelines, and generation history stay in your local workspace.\n- **Canvas and Editor stay connected.** A generated result becomes a reusable project Asset instead of disappearing inside one tool.\n- **Bring your own Agent.** Codex, Claude Code, Cursor, and other MCP hosts can inspect and update the same Project you see in the browser.\n- **Bring your own generation access.** BeatAPI is the built-in provider. Local importing, arranging, editing, previewing, and exporting do not require an API key.\n- **Fork-friendly foundations.** Provider adapters, project storage, and the command layer are explicit extension points.\n\n## From idea to finished video\n\n```text\nPrompt or local media\n        ↓\nInfinite Canvas ─── connect, generate, branch, compare\n        ↓\nShared Assets ───── images, video, audio, extracted clips\n        ↓\nVideo Editor ────── trim, arrange, preview, export MP4\n        ↑\nAny MCP Agent ───── works in the same local Project\n```\n\n## Quick start\n\nRequirements include Node.js 22+, `pnpm` 10+, and a current Chrome browser on macOS or Windows.\n\n```bash\npnpm install\npnpm db:push\npnpm dev\n```\n\nOpen [http://127.0.0.1:3020](http://127.0.0.1:3020).\n\nAdd your own [BeatAPI API key](https://beatapi.io/dashboard/apikeys) only when you want to generate or analyze media, or use AI redo. Selecting a local file does not upload it to a provider.\n\n### Choose how to run BeatDesign\n\n| Command | Starts |\n| --- | --- |\n| `pnpm dev` | The visual workspace |\n| `pnpm dev:agent` | The visual workspace and local HTTP MCP endpoint |\n| `pnpm mcp` | The stdio MCP server for coding Agents |\n\n## Use BeatDesign with an Agent\n\nBeatDesign 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.\n\nAfter connecting your MCP host, you can ask:\n\n> 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.\n\n## Platform compatibility\n\n| Coding Agent / platform | Status | Quick setup |\n| --- | --- | --- |\n| [Claude Code](./integrations/claude-code/beatdesign/README.md) | ✅ Supported | [Plugin or MCP config](./integrations/claude-code/) |\n| [Codex](./integrations/codex/beatdesign/README.md) | ✅ Supported | [Plugin setup](./integrations/codex/beatdesign/README.md) |\n| [ZCode](./integrations/zcode/config.example.json) | ✅ Supported | [MCP config](./integrations/zcode/config.example.json) |\n| [OpenCode](./integrations/opencode/) | ✅ Supported | [MCP config](./integrations/opencode/) |\n| [Cursor](./integrations/cursor/mcp.json.example) | ✅ Supported | [MCP config](./integrations/cursor/mcp.json.example) |\n| [Windsurf](./integrations/windsurf/mcp_config.json.example) | ✅ Supported | [MCP config](./integrations/windsurf/mcp_config.json.example) |\n| [VS Code + GitHub Copilot](./integrations/vscode/mcp.json.example) | ✅ Supported | [MCP config](./integrations/vscode/mcp.json.example) |\n| [Cline / Roo Code](./integrations/cline/mcp_settings.json.example) | ✅ Supported | [MCP config](./integrations/cline/mcp_settings.json.example) |\n| [Qwen Code](./integrations/qwen/settings.example.json) | ✅ Supported | [MCP config](./integrations/qwen/settings.example.json) |\n| [Gemini CLI](./integrations/gemini/settings.example.json) | ✅ Supported | [MCP config](./integrations/gemini/settings.example.json) |\n| [Hermes Agent](./integrations/hermes/config.yaml.snippet) | ✅ Supported | [MCP config](./integrations/hermes/config.yaml.snippet) |\n| [Kiro](./integrations/kiro/mcp.json.example) | ✅ Supported | [MCP config](./integrations/kiro/mcp.json.example) |\n| [Trae](./integrations/trae/mcp.json.example) | ✅ Supported | [MCP config](./integrations/trae/mcp.json.example) |\n| [WorkBuddy](./integrations/workbuddy/beatdesign/README.md) | ✅ Supported | [Connector setup](./integrations/workbuddy/beatdesign/README.md) |\n| [QwenWork](./integrations/qwenwork/mcp.json.example) | ✅ Supported | [HTTP connector](./integrations/qwenwork/mcp.json.example) |\n| [Doubao Work](./integrations/doubao-work/mcp.json.example) | ✅ Supported | [HTTP connector](./integrations/doubao-work/mcp.json.example) |\n\n[Open the full Agent integration guide →](./integrations/README.md)\n\n## What works today\n\n- Image and video generation plus Standard and Deep video analysis.\n- Image, video, audio, generation, timeline, and text nodes on the Canvas.\n- Project Assets shared across Studio, Canvas, Editor, and MCP.\n- Non-destructive timeline editing with image, video, audio, movable image overlays, and styled SRT caption tracks.\n- Local preview and browser-side H.264/AAC MP4 export with WebCodecs and Mediabunny.\n- English, Chinese, and Japanese interfaces.\n- Local stdio and Streamable HTTP MCP transports.\n\nBeatDesign 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.\n\n[See the complete shipped and planned scope →](./docs/PRODUCT_PLAN_AND_STATUS.md)\n\n## Project guides\n\n- [Product status](./docs/PRODUCT_PLAN_AND_STATUS.md)\n- [MCP setup](./docs/MCP.md)\n- [Architecture](./docs/ARCHITECTURE.md)\n- [Provider integration](./docs/PROVIDERS.md)\n- [Contributing](./.github/CONTRIBUTING.md)\n- [Security](./.github/SECURITY.md)\n\n## License\n\nBeatDesign is licensed under [Apache License 2.0](./LICENSE). BeatAPI and BeatDesign trademarks, third-party model access, and bundled third-party components remain subject to their respective terms. See [third-party notices](./third_party/) and [trademark policy](./docs/TRADEMARKS.md).\n",
  "bytes": 7465,
  "sha": "fe4085ad735c2cc68c6e4634e67224d62d6e85968387473a2cdd84056d5f744c",
  "repo_slug": "beatapi/beatdesign",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_erickkkyt_beatdesign_3cbaff84/readme"
}