项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-04 · 当前星标 ★ 1233
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 运行环境(建议使用当前 LTS 版本)
- pnpm 包管理器
- 可用的 PostgreSQL 数据库(Vercel 部署时自动创建 Neon 数据库)
- Better Auth 认证所需凭据
- AI Gateway API Key(用于自然语言生成工作流)
安装与启动步骤
-
1安装 pnpm
项目使用 pnpm 管理依赖,先确认 Node.js 已安装,再全局安装 pnpm。
npm install -g pnpm -
2获取项目代码
从 GitHub 克隆模板仓库到本地,再进入项目目录。
git clone https://github.com/vercel-labs/workflow-builder-template.git cd workflow-builder-template -
3安装依赖
在项目根目录执行依赖安装,README 给出的安装命令为 pnpm install。
pnpm install -
4配置环境变量
按 README 提示准备 Better Auth 凭据与 AI Gateway API Key,并配置数据库连接信息。
-
5初始化数据库
执行 README 中的数据库迁移命令,把表结构推送到已配置的 PostgreSQL 数据库。
pnpm db:push -
6启动开发服务
README 节选未包含启动命令,请按仓库 Getting Started 完整说明运行本地服务。
-
7或一键部署 Vercel
在 Vercel 上导入仓库并一键部署,部署过程中会自动创建并连接 Neon Postgres。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
Better Auth 凭据 | 是 | 用于用户注册登录与会话校验的认证配置 | your-better-auth-secret |
AI Gateway API Key | 是 | 调用 OpenAI 等模型,由自然语言生成工作流 | sk-xxxxxxxx |
PostgreSQL 连接信息 | 是 | 工作流、运行记录等数据的存储地址 | postgres://user:password@host:5432/dbname |
如何确认成功
pnpm db:push 无报错,且本地服务启动后能打开可视化工作流画布页面。
常见问题
Q:提示 pnpm 命令不存在怎么办?
A:先执行 npm install -g pnpm 全局安装,再用 pnpm -v 确认安装成功,然后重新执行安装命令。
Q:数据库迁移失败怎么排查?
A:确认数据库已创建且连接信息正确、账号有建表权限,再重新执行 pnpm db:push。
Q:部署时需要准备哪些环境变量?
A:README 说明需要提供 Better Auth 认证凭据与 AI Gateway API Key,数据库由平台自动创建。
Q:工作流能导出为代码吗?
A:可以,模板支持把工作流转换为带 "use workflow" 指令的可执行 TypeScript 代码。
注意事项
- 环境变量中包含密钥,不要提交到 Git 仓库或公开分享
- Vercel 部署方式会自动创建并连接 Neon Postgres 数据库
- README 节选不完整,启动命令与更多配置请以仓库完整文档为准
核心亮点
- 提供可视化画布与节点连线编辑,省去从零开发编排界面的工作量
- 内置 AI 智能体与工作流概念,模板结构清晰,便于按业务接入自定义节点
- TypeScript 技术栈,类型完整,适合前端团队二次开发和维护
不足之处
- 作为模板项目,生产级能力如权限、持久化、并发调度需自行补齐
- 文档与社区规模仍在成长,遇到问题可参考的案例有限
适用场景
- 快速搭建 AI 自动化工具的内部原型
- 为团队定制多步骤内容生成或数据处理流程
- 教学演示中展示可视化工作流编排原理
替代项目
n8n、Dify、Flowise
下一篇:self-hosted
同类项目推荐
nudgebee
开源
一个平台搞定云运维、成本与 K8s,告别工具切换
Open-source agentic ops platform for cloud, SRE, DevOps, support and FinOps teams. A···
awesome-n8n-templates
开源
海量现成 n8n 工作流,检索即导入,省去从零搭建
The largest open-source collection of n8n workflow templates — 8,697+ ready-to-impo···
flatkey-cli
开源
终端一键生成图像、视频、音频,探索 AI 模型。
Flatkey media generation CLI for images, videos, audio, text, credits, and model dis···
xiaozhi-esphome
开源
把小智音箱刷进 Home Assistant,语音控制全屋设备
Alternative code to use xiaozhi ai devices in esphome/home assistant.
spider
开源
让 AI 智能体轻松抓取网页数据,告别反爬烦恼
Foundational low latency web data collecting in Rust
any-auto-register
开源
一键自动注册并管理 13+ AI 平台账号,告别手动填表
Auto-register & manage accounts for ChatGPT, Cursor, Kiro, Grok, Windsurf, Trae & 13···
hanzi-browse
开源
让 AI 直接操控你的浏览器,自动完成网页操作
let any ai agent use the local browser
promptwright
开源
说人话,自动生成可运行的浏览器测试脚本
Login-less, bring-your-own-key desktop agent that turns plain English into browser a···
reels-af
开源
一键自动生成病毒式短视频,成本低至1毛钱
Automate viral reel/tik-tok videos via AI multi-agent system. ~$0.1/reel.
