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:
    1. FlowGram Desktop – a native macOS/Windows app that offers a full‑featured “Agent workspace” with versioning, debugging, and project management.
    2. 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 LICENSE badge).

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