node-banana

拖拽节点连成线，几步搭出 AI 生成流水线

开源 freemium 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1635

维护状态活跃

是否开源是

定价模式 freemium

项目预览

项目数据

分类自动化工作流

开发团队shrimbly

所属国家

官网地址https://nodebanana.app

GitHubhttps://github.com/shrimbly/node-banana

定价模式freemium

价格说明免费开源，官网提供在线使用，可能有付费增值功能，具体定价待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 1635

30天Star增速

HF 下载量

上线时间2025-12-03 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-20

浏览次数0

项目介绍

node-banana 是一个基于 TypeScript 构建的开源节点式生成工作流工具，定位为免费、开放的 AI 生成流程编排平台。它把图像生成、文本生成等 AI 能力封装成可拖拽的节点，用户通过连线组合节点即可搭建从输入到输出的自动化流水线，无需编写代码。项目解决的是 AI 生成任务中多步骤串联、参数复用和流程可视化的痛点：传统方式需要手动调用 API 或写脚本，而 node-banana 用图形化画布把模型调用、参数配置和结果传递直观呈现，并支持保存和复用工作流。核心能力包括节点画布编辑、多模型接入、工作流执行与结果预览，适合快速试验生成效果和搭建可重复使用的创作管线。项目处于成长阶段，社区和生态仍在扩展中。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

Node.js 与 npm（README 未标注具体版本）
macOS 13+（Apple Silicon）或 Windows 10+（x64），仅在使用桌面版时需要
所用 AI 提供商的 API Key（BYOK，费用由你自行承担）
仅在运行 ComfyUI 工作流时需要 ComfyUI 或 Comfy Cloud 账号

安装与启动步骤

1下载桌面版

在官网按平台下载安装包：Mac 为已签名公证的 DMG，Windows 为 x64 安装程序。
2克隆仓库

想从源码运行而非用安装包时，先克隆本仓库并进入目录。
```
git clone https://github.com/shrimbly/node-banana.git
cd node-banana
```
3安装依赖

在项目根目录用 npm 安装全部依赖，需联网，耗时取决于网速。
```
npm install
```
4启动开发服务

启动本地开发服务器，默认只监听 127.0.0.1。
```
npm run dev
```
5打开画布页面

浏览器访问本地地址即可看到节点画布界面。
6填写 API 密钥

进入 Settings → Providers，粘贴各提供商的 API Key，密钥加密存储在系统用户配置中。
7可选：局域网访问

构建后以 HOST=0.0.0.0 启动，供其它设备访问；仅在可信网络或带鉴权的代理后使用。
```
npm run build
HOST=0.0.0.0 npm start
```

关键配置

配置项	必填	说明	示例
`Providers API Key`	是	在应用内 Settings → Providers 填入，用于直接调用各 AI 提供商	`sk-xxxxxxxx`
`HOST`	否	监听地址，默认仅 127.0.0.1；改为 0.0.0.0 可被外部设备访问	`0.0.0.0`
`ComfyUI 运行位置`	否	在 Settings → ComfyUI 选择 Comfy Cloud、本机或远程	`http://127.0.0.1:8188`
`Comfy Cloud API Key`	否	选用 Comfy Cloud 时从 platform.comfy.org 获取的密钥	`你的 Comfy Cloud API Key`

如何确认成功

终端显示服务监听 127.0.0.1:3000，浏览器打开 http://localhost:3000 能看到节点画布即可。

常见问题

Q：Windows 首次运行被 SmartScreen 拦截怎么办？

A：Windows 版未做代码签名，属于正常提示，需手动确认继续运行；可从 GitHub Releases 核对安装包 SHA-256 校验值。

Q：工作流和生成的图片存在哪里？

A：默认保存在系统「文档」目录下的 Node Banana 文件夹中，工作流还可导出为可移植的 JSON 文件分享。

Q：手机或其它电脑能访问吗？

A：默认只监听 127.0.0.1。需设置 HOST=0.0.0.0 启动，但该接口可读写本地工作流文件并会消耗密钥，务必只在可信网络或带鉴权的代理后使用。

Q：必须自己准备 API Key 吗？

A：是的，项目为 BYOK 模式，应用用你的密钥直连各提供商，调用费用由提供商向你计费。

Q：必须安装 ComfyUI 吗？

A：不是。可直接用默认的 Comfy Cloud（填 API Key 即可、无需 GPU），也可连本机或远程 ComfyUI。

注意事项

README 未给出 npm start 之外的端口配置方式，默认端口为 3000。
HOST=0.0.0.0 会暴露读写本地文件与消耗密钥的接口，谨慎开启。
Windows 安装包未签名，首次运行可能出现 SmartScreen 警告。
桌面版会从 GitHub Releases 自动更新，可用官方 SHA-256 校验安装包。

核心亮点

节点式可视化编排，生成流程无需写代码即可搭建和调整
免费开源，可自行部署，不依赖商业平台订阅
基于 TypeScript 实现，前后端技术栈统一，便于二次开发和扩展

不足之处

项目较新，节点类型和预置模板数量有限，复杂流程覆盖不足
社区规模尚小，文档和第三方教程较少，遇到问题可参考的资料不多

适用场景

批量生成商品图或插画，把提示词、模型和输出节点串成可复用流水线
团队内快速试验不同生成模型和参数组合，对比效果
个人创作者搭建自动化内容生产流程，减少重复手工操作

替代项目

ComfyUI、Flowise

上一篇：blender-ai-mcp-addon

下一篇：doit