脚手架建项目时建议选 Free Layout Demo 模板,否则示例结构不同;启动后默认访问 http://localhost:3000,端口被占用需自行处理;Desktop 预览版安装包未签名,macOS 未公证
flowgram.ai
bytedanceMIT活跃维护一套可扩展的工作流开发框架,内置画布、表单、变量和物料,帮开发者更快搭建 AI 工作流平台。
FlowGram is an extensible workflow development framework with built-in canvas, form, variable, and materials that helps developers build AI workflow platforms faster and simpler.
npx @flowgram.ai/create-app@latest
cd demo-free-layout && npm install && npm startREADME 未说明,属于前端/Node 项目,按 Quick Start 在本地 Node 环境运行即可
字节开源的可扩展工作流开发框架,内置画布、表单和变量,帮你更快搭 AI 工作流平台
一套可扩展的工作流开发框架,内置画布、表单、变量和物料,帮开发者更快搭建 AI 工作流平台。
核心能力
- 提供自由布局与固定布局两种流程画布
- 内置表单引擎管理节点数据的增删改查与校验
- 变量引擎支持作用域约束与类型推断
- 自带 LLM、条件、代码编辑器等即用物料
- 提供 FlowGram Desktop 原生工作台用于调试与发布
容易踩的坑
- desktop-previewFlowGram Desktop Previewpre-release2026-10-21 · 2026-10-21 07:32 UTC
查看更新说明
FlowGram Desktop preview 0.1.0 for macOS Apple Silicon, macOS Intel and Windows x64.
Download the installer for your platform below. The download URLs stay the same when this preview is updated.
Source: https://github.com/bytedance/flowgram.ai/commit/841496dc01d785b3dbb10a433bd53c81701cc314
Build: https://github.com/bytedance/flowgram.ai/actions/runs/39557419177
Checksums: SHA256SUMS.txt. Build provenance: build-info.json.
Preview installers are unsigned; macOS builds are not notarized.
- v1.0.16最新正式版2026-10-13 · 2026-10-13 10:03 UTC
What's Changed
- fix: mobile two finger gesture by @dragooncjw in https://github.com/bytedance/flowgram.ai/pull/1177
- fix(document): serialize parents from the origin tree by @Linxiushen in https://github.com/bytedance/flowgram.ai/pull/1200
- fix(runtime): bound task retention in workflow application by @louisyoungx in https://github.com/bytedance/flowgram.ai/pull/1201
- fix(free-layout-core): recompute line path when version unchanged but path is empty by @zyh94946 in https://github.com/bytedance/flowgram.ai/pull/1147
- chore(ci): upgrade actions/checkout and actions/setup-node to v4 by @MeiSiristhebest in https://github.com/bytedance/flowgram.ai/pull/1159
- fix(runtime): evaluate unary string conditions by @Gujiassh in https://github.com/bytedance/flowgram.ai/pull/1218
- fix(antd-materials): preserve variable paths and filter readonly by @louisyoungx in https://github.com/bytedance/flowgram.ai/pull/1226
- fix(demo): remap group membership when pasting loops by @louisyoungx in https://github.com/bytedance/flowgram.ai/pull/1225
- fix(core): exit Space grab after unrelated key presses by @louisyoungx in https://github.com/bytedance/flowgram.ai/pull/1224
- fix(cli): scaffold projects without partial mutations by @dvd233 in https://github.com/bytedance/flowgram.ai/pull/1176
- fix(demo-free-layout): reset panel lock after select by @abin-zh in https://github.com/bytedance/flowgram.ai/pull/1138
- fix(demo): avoid duplicate IDs within a paste batch by @dvd233 in https://github.com/bytedance/flowgram.ai/pull/1223
New Contributors
- @Linxiushen made their first contribution in https://github.com/bytedance/flowgram.ai/pull/1200
- @zyh94946 made their first contribution in https://github.com/bytedance/flowgram.ai/pull/1147
- @MeiSiristhebest made their first contribution in https://github.com/bytedance/flowgram.ai/pull/1159
- @dvd233 made their first contribution in https://github.com/bytedance/flowgram.ai/pull/1176
- @abin-zh made their first contribution in https://github.com/bytedance/flowgram.ai/pull/1138
Full Changelog: https://github.com/bytedance/flowgram.ai/compare/v1.0.14...v1.0.16
- v1.0.142026-08-20 · 2026-08-20 06:11 UTC
查看更新说明
What's Changed
- fix(playground): editorState esc mode only exit by escape by @xiamidaxia in https://github.com/bytedance/flowgram.ai/pull/1164
Full Changelog: https://github.com/bytedance/flowgram.ai/compare/v1.0.13...v1.0.14
- v1.0.13V1.0.132026-08-12 · 2026-08-12 04:48 UTC
查看更新说明
What's Changed
- feat(demo): add fixed layout HTTP node by @Gujiassh in https://github.com/bytedance/flowgram.ai/pull/1142
- feat(free-lines-plugin): support custom renderLine, defaultLineUiState, customLineProps by @xiamidaxia in https://github.com/bytedance/flowgram.ai/pull/1154
- fix: license by @dragooncjw in https://github.com/bytedance/flowgram.ai/pull/1156
Full Changelog: https://github.com/bytedance/flowgram.ai/compare/v1.0.12...v1.0.13
- v1.0.122026-06-08 · 2026-06-08 08:38 UTC
查看更新说明
What's Changed
- fix(form-materials): support enum constant input by @sanmaopep in https://github.com/bytedance/flowgram.ai/pull/1127
- feat(json-schema): support array item icons by @sanmaopep in https://github.com/bytedance/flowgram.ai/pull/1128
- fix(demo-free-layout): correct expand shortcut by @Gujiassh in https://github.com/bytedance/flowgram.ai/pull/1133
- fix: polyfill drag node undefined by @dragooncjw in https://github.com/bytedance/flowgram.ai/pull/1140
- chore: composite workflows by @dragooncjw in https://github.com/bytedance/flowgram.ai/pull/1141
- fix: publisher use latest npm. del auth token registry by @dragooncjw in https://github.com/bytedance/flowgram.ai/pull/1144
- fix: repository.url by @dragooncjw in https://github.com/bytedance/flowgram.ai/pull/1145
New Contributors
- @Gujiassh made their first contribution in https://github.com/bytedance/flowgram.ai/pull/1133
Full Changelog: https://github.com/bytedance/flowgram.ai/compare/v1.0.11...v1.0.12
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
FlowGram|Workflow development framework
English | 中文 | Español | Русский | Português | Deutsch | 日本語
FlowGram is a composable, visual, easy-to-integrate, and extensible workflow development framework & toolkit. Our goal is to help developers build AI workflow platforms faster and simpler. FlowGram comes with a suite of built-in tools for workflow development: flow canvas, node configuration form, variable scope chain, and ready-to-use materials (LLM, Condition, Code Editor etc). The framework packages provide the building blocks for your own workflow platform; FlowGram Desktop brings them together in a native Agent workspace.
Learn more at FlowGram.AI 🌐
🖥️ FlowGram Desktop
FlowGram Desktop is a native Agent workspace for macOS and Windows. Build, run, debug, and reuse workflows through conversation and a visual canvas.
- Build: describe a task in chat, then refine nodes, conditions, parallel branches, joins, and loops on the canvas.
- Debug: test individual nodes, inspect inputs and outputs, and revisit execution paths and historical workflow snapshots.
- Reuse: publish versioned workflows for HTTP and MCP consumers, or call them from other workflows.
- Organize: manage project-based workflows and chats, import and export projects, and work in English or Simplified Chinese with light and dark themes. Six industry example projects help you get started.
https://github.com/user-attachments/assets/48c0e187-5bd8-40b2-9a96-60d3839db170
Download Desktop
macOS — install with one command (Apple Silicon and Intel):
curl --fail --silent --show-error https://flowgram.ai/desktop/install.sh | sh
Paste into Terminal to download the latest preview, verify its SHA-256 checksum, and install FlowGram. The script removes quarantine only from the installed app so the unsigned preview can open. No sudo is required. Run the same command to update; quit FlowGram first.
Choose your platform to download the latest preview. These permanent links are updated automatically after all three platform builds succeed.
| Platform | Download |
|---|---|
| macOS · Apple Silicon (ARM64) | Download DMG |
| macOS · Intel | Download DMG |
| Windows 10/11 · x64 | Download EXE |
Download the installer directly; no GitHub sign-in is required. Open the .dmg on macOS or run the setup .exe on Windows. Checksums and build information are available on the release page. Preview installers are unsigned; macOS builds are not notarized.
🎬 Demo
https://github.com/user-attachments/assets/fee87890-ceec-4c07-b659-08afc4dedc26
Open in CodeSandbox 🌐 or StackBlitz 🌐
In this demo, we iterate through a list of cities, fetch real-time weather via HTTP, parse temperatures with a Code node, generate outfit suggestions with an LLM, gate by a Condition, aggregate results across the loop, and finally use an Advisor LLM to pick the most comfortable city before sending the result to the End node.
🚀 Quick Start
- Create a new FlowGram project:
npx @flowgram.ai/create-app@latest
We recommend choosing the
Free Layout Demo ⭐️template.
- Start the project:
cd demo-free-layout
npm install
npm start
- Open http://localhost:3000 in your browser.
✨ Features
| Feature | Description | Demo |
|---|---|---|
| Free Layout Canvas | Free layout canvas where nodes can be placed anywhere and connected using free-form lines. | ![]() |
| Fixed Layout Canvas | Fixed layout canvas where nodes can be dragged to specified positions, with support for compound nodes like branches and loops. | ![]() |
| Form | The form engine manages the CRUD operations of node data and provides rendering, validation, side effects, linkage, and error-capturing capabilities, simplifying the development of node configurations. | |
| Variable | The variable engine supports scope constraints, variable structure inspection, and type inference, making it easy to manage data flow within the workflow. |
📖 Documentation
You can find the FlowGram documentation on the website.
The documentation is divided into several sections:
- Quick Start
- Canvas
- Form
- Variable
- Material
- Runtime
- Advanced Guides
- API Reference
- Where to get Support
- Contributing Guide
🙌 Contributors
🌍 Adoption
- Coze Studio is an all-in-one AI agent development tool. Providing the latest large models and tools, various development modes and frameworks, Coze Studio offers the most convenient AI agent development environment, from development to deployment.
- NNDeploy is a workflow-based multi-platform ai deployment tool.
- Certimate is an open-source SSL certificate management tool that helps you automatically apply for and deploy SSL certificates with a visual workflow. It is one of the ACME client options listed in the official documentation of Let's Encrypt.
📬 Contact us
- Issues: Issues
- Lark: Scan the QR code below with Register Feishu to join our FlowGram user group.

