bytedance/flowgram.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.
FlowGram – Visual workflow framework for AI agents
What it is
- An open‑source toolkit (bytedance/flowgram.ai) that lets you build, run and debug AI‑driven workflows with a visual canvas and a chat‑based interface.
- Provides reusable building blocks such as LLM nodes, conditionals, code editors, variable handling, and HTTP calls.
- Comes in two flavors:
- FlowGram Desktop – a native macOS/Windows app that offers a full‑featured “Agent workspace” with versioning, debugging, and project management.
- Web SDK – a set of npm packages (e.g.,
@flowgram.ai/editor) you can embed in your own web app to create custom workflow platforms.
Key features
| Feature | What it does |
|---|---|
| Free‑layout canvas | Drag nodes anywhere, connect with free‑form lines; ideal for ad‑hoc designs. |
| Fixed‑layout canvas | Nodes snap to a grid and support compound structures like branches, loops, and joins. |
| Form engine | Generates configuration forms for each node, handling validation, side‑effects and CRUD automatically. |
| Variable engine | Scoped variables with type inference and inspection, simplifying data flow between nodes. |
| Built‑in materials | Ready‑made nodes for LLM calls, HTTP requests, code execution, conditions, etc. |
| Debugging tools | Run individual nodes, view inputs/outputs, step through execution paths, and inspect historical snapshots. |
| Versioned publishing | Export workflows as HTTP or MCP services, or call them from other workflows. |
| Multi‑language UI | English and Simplified Chinese UI, with light/dark themes. |
Getting started
# Create a new project from the official template
npx @flowgram.ai/create-app@latest
# Choose the "Free Layout Demo" template when prompted
cd demo-free-layout
npm install
npm start # opens http://localhost:3000
You can then use the web UI to add nodes, connect them, and test the workflow.
Desktop app
- Download the latest preview builds from the GitHub Actions artifacts (macOS ARM64, macOS Intel, Windows x64).
- The installers are unsigned and expire after 14 days; fetch a fresh build for the newest version.
- The desktop client lets you describe a task in chat, automatically creates an initial node graph, and lets you refine it visually.
Documentation & community
- Full docs live at https://flowgram.ai (quick‑start, canvas guides, form/variable APIs, runtime details, advanced topics).
- Support via GitHub Issues and a Lark (Feishu) user group (QR code in the repo).
- Adoption examples include Coze Studio, NNDeploy, and Certimate, showing that the framework can power both AI‑agent studios and non‑AI workflow tools.
License
- Distributed under the repository’s open‑source license (see
LICENSEbadge).
Who might use it
- Developers building custom AI‑assistant platforms who want a visual, low‑code way to stitch together LLM calls, data processing, and external APIs.
- Teams that need a reusable workflow engine for both AI and general automation tasks.
All information above is taken directly from the repository’s README; no additional claims have been added.
Related
- Project
- Project
- Project
- Project
- Project