快速开始

TongFlow 以 Next.js 开发服务器的形式跑在你自己的机器上。跑通第一个工作流大约需要 5 分钟。

需要准备

  • Node.js 20 及以上，装好 pnpm
  • 一个 Modal 账号和 Token——到 modal.com 注册。免费额度每月 30 美元，包含相当可观的 H100 时间，足够覆盖 TongFlow 绝大部分 GPU 任务
  • 至少一个 LLM API Key——四选一：OpenRouter、Gemini、OpenAI、DeepSeek。OpenRouter 有免费路由层，其余按调用计费

可选：一个 Discord 账号，有问题到 #tongflow 找我们。

1. 克隆仓库

git clone https://github.com/tong-io/tongflow
cd tongflow

2. 配置环境变量

复制示例文件，然后编辑：

cp .env.example .env

必填变量：

变量用途
MODAL_TOKEN_IDModal Worker 鉴权
MODAL_TOKEN_SECRETModal Worker 鉴权
以下至少一个：OPENROUTER_API_KEY / GEMINI_API_KEY（或 GOOGLE_API_KEY）/ OPENAI_API_KEY / DEEPSEEK_API_KEY”Generate text” 节点，以及其他走 LLM 的转换

可选变量：

  • OPENROUTER_FREE_MODEL —— 钉住某条 OpenRouter 免费路由
  • OPENAI_CHAT_MODEL —— 不设时默认 gpt-4o-mini
  • NEXT_PUBLIC_FILE_BASE_URL —— 前面挂了 CDN 时，文件服务的 base URL

3. 一次性授权 Modal

把 Token 写进 ~/.modal.toml，只需在首次运行前执行一次：

pnpm modal:setup

4. 启动

需要 Node.js 20 及以上。

pnpm install
pnpm dev

打开 http://localhost:3000，会自动落到 /workspace。

数据都存在本地：SQLite 在 data/tongflow.db，上传文件在 data/uploads/。

5. 第一个工作流

/workspace 加载完成后：

  1. 页面默认处于 Create Mode（创作模式，模式开关上的 Sparkles 图标——见 工作流模式）。
  2. 底部的 智能岛（Smart Island） 显示 7 个添加图标：3D / 文档 / 图像 / 文本 / 视频 / 音频 / 链接。
  3. 点 文本（Type 字母图标）放一个文本节点，输入提示词，比如 “图书馆里一只猫的水彩肖像”。
  4. 从文本节点右侧的输出 handle 拖到空白画布 → 选 图像生成 → 一个已经连好线的图像节点就出现了。
  5. 切到 Execute Mode（执行模式，把开关从 Sparkles 切到 Play），点智能岛上的 Play 按钮。
  6. 任务经由你的 Modal 账号执行，结果出现在图像节点上。

整个循环就这些。接下来可以再串一个转换（图→视频、图→3D、图像放大），分支到一个组合节点（比如口型同步），或者把工作流保存下来。

各种数据在哪儿

  • 工作流 —— 存在 data/tongflow.db。从左上角侧栏的第一个按钮（Workflow）打开。
  • 素材 / Portfolio —— 上传过的文件在 Portfolio 对话框里（左上角第三个按钮，FolderOpen 图标，不在智能岛上）。
  • 任务历史 —— Task 面板（左上角第二个按钮，Zap 图标）。

下一步