nodetool Agent工作流
nodetool Agent工作流 是 AI Skill Hub 本期精选Agent工作流之一。综合评分 8.2 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。
nodetool Agent工作流 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.2 分，是同类 Agent 工作流中的精选推荐。
nodetool Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
nodetool Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g nodetool # 方式二：npx 直接运行（无需安装） npx nodetool --help # 方式三：项目依赖安装 npm install nodetool # 方式四：从源码运行 git clone https://github.com/nodetool-ai/nodetool cd nodetool npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
nodetool --help
# 基本用法
nodetool [options] <input>
# Node.js 代码中使用
const nodetool = require('nodetool');
const result = await nodetool.run(options);
console.log(result);
# nodetool 配置说明 # 查看配置选项 nodetool --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export NODETOOL_CONFIG="/path/to/config.yml"
NodeTool
The open creative AI workspace.
Every model. Your keys. Your canvas.
NodeTool is the open-source creative AI workspace — every major model from every major provider, called with your own keys, wired into one node-based canvas you run on your machine.
Bring your own keys to FAL, KIE, Atlas, OpenAI, Anthropic, Gemini, Replicate, ElevenLabs, HuggingFace. Pay providers directly at provider prices. Switch the moment a better model ships. Wire it all into one canvas with the editing tools you rely on — masks, inpaint, outpaint, relight, upscale, layers, compositing.
What's in the box
| **Node-based canvas** | Drag-and-drop nodes with type-safe connections |
| **Image, video, audio, text** | Unified workflows across every modality |
| **Editing tools as nodes** | Mask, inpaint, outpaint, relight, upscale, layers, compositing |
| **Runs on your machine** | Ollama, MLX (Apple Silicon), and GGUF for local inference |
| **BYOK everywhere** | OpenAI, Anthropic, Gemini, FAL, KIE, Replicate, ElevenLabs, HuggingFace |
| **Document search** | Built-in vector store for indexing and querying your files |
| **Real-time previews** | Live output at every node as the workflow runs |
| **Custom nodes** | Extend in TypeScript or Python |
| **Deploy anywhere** | Docker, RunPod, Google Cloud Run, or self-hosted |
| **Cross-platform** | Desktop, web, CLI, and mobile |
Electron E2E (requires xvfb on Linux headless)
cd electron && npm run vite:build && npx tsc cd electron && npx playwright install chromium && npm run test:e2e ```
For detailed testing documentation, see web/TESTING.md.
______________________________________________________________________
What people build with it
The workspace is a canvas, not a wizard. A few of the patterns we see most often:
- Image generation and editing — FLUX.2, Nano Banana Pro, GPT-Image 3, plus mask, inpaint, outpaint, relight, and upscale as first-class nodes.
- Video — Seedance, Sora 2 Pro, Veo 3.1, Wan 2.6, Hailuo 2.3, Kling 2.6. Text-to-video, image-to-video, and video-to-video pipelines.
- Voice and audio — Whisper for transcription, ElevenLabs and OpenAI TTS for speech, audio analysis and editing as nodes.
- Document search — point a workflow at a folder, embed it, query it. RAG without writing the plumbing.
- Multi-step agents — agents are a capability inside the workspace, not a separate product. Wire one into a graph when a step needs to plan, decide, or call tools.
- Mini-apps — share a workflow as an interactive web app others can run.
Install globally (Node.js 22.x required)
npm install -g @nodetool-ai/cli
One-off without global install
npx --package=@nodetool-ai/cli nodetool serve npx --package=@nodetool-ai/cli nodetool-chat --agent ```
See the CLI Reference for all commands.
______________________________________________________________________
Development Setup
Prerequisites: Node.js 22.22.1, npm. Python 3.11 with conda for Python nodes (optional).
Node 22.22.1 is required. Matches Electron 39's embedded Node so dev and the packaged app run on the same Node version. Usenvm useto activate (reads.nvmrc).
Uses tsx --watch for the backend, so startup skips a full websocket package rebuild.
npm run dev ```
Quick Start
```bash nvm use # Activate Node 22.22.1 (reads .nvmrc) npm install npm run build:packages # Build all TS packages in dependency order
Python Nodes (optional)
Python nodes (HuggingFace, MLX, Apple integrations) run via the PythonStdioBridge, which spawns a Python worker process that communicates over stdin/stdout. The bridge connects lazily on the first workflow that uses Python nodes — no separate setup is needed for the TypeScript backend.
CLI & Server (npm)
Run the server, execute workflows, or chat from the terminal:
```bash
Start the API server (port 7777)
nodetool serve
Run a TypeScript DSL workflow
nodetool workflows run my-workflow.ts
How NodeTool compares
| NodeTool | ComfyUI | Weavy | n8n | |
|---|---|---|---|---|
| **Built for** | Creatives working with AI | Stable Diffusion power users | Creative teams (now part of Figma) | Business workflows |
| **Modalities** | Image, video, audio, text | Image, video | Image, video | Text |
| **Models** | Every major provider, BYOK | Stable Diffusion | Curated marketplace | API integrations |
| **Source & pricing** | AGPL-3.0, provider prices | Open source, free | Closed, credits | Fair-code, subscription |
vs ComfyUI. ComfyUI exposes every parameter for engineers who want them. NodeTool keeps the node-based power, gives it an interface that doesn't fight you, and covers the rest of the stack — video, audio, text, document search.
vs Weavy. Weavy was the closed-source canvas for creative AI. After the Figma acquisition, the roadmap belongs to someone else. NodeTool is the open alternative — same node-based canvas, your keys, your files, no acquisition risk.
vs n8n. n8n is for business workflows and API plumbing. NodeTool is built for creative work — models, masks, layers, video, audio, RAG.
NodeTool 是一个开放创造性的 AI 工作空间。它提供了一个可扩展的工作环境，支持各种模型和关键。您可以在 NodeTool 中创建自己的工作流程，使用各种编辑工具和节点。
NodeTool 提供了一个基于节点的画布，支持图像、视频、音频和文本的统一工作流程。它还支持各种编辑工具，例如遮罩、填充、扩展、重光、层次和合成。NodeTool 还支持在本地机器上运行，包括 Ollama、MLX 和 GGUF 等。
NodeTool 需要 Electron E2E 运行，需要 xvfb 在 Linux 头屏幕下安装。具体测试文档，请参见 [web/TESTING.md](web/TESTING.md)。
要安装 NodeTool，需要在 Node.js 22.x 环境下使用 npm 安装 @nodetool-ai/cli。您也可以使用 npx 一次性安装。具体安装步骤，请参见 [INSTALL](#install) 部分。
要使用 NodeTool，首先需要激活 Node 22.22.1 环境，然后使用 npm 安装依赖包，最后使用 npm 运行 build:packages 构建所有 TS 包。具体使用教程，请参见 [USAGE](#usage) 部分。
NodeTool 支持 Python 节点（可选），这些节点通过 PythonStdioBridge 运行，使用 HuggingFace、MLX 和 Apple 等集成。具体配置说明，请参见 [CONFIG](#config) 部分。
NodeTool 提供了 CLI 和 Server API，允许您在终端中启动服务器，执行工作流程或与 AI 机器人聊天。具体 API 文档，请参见 [API](#api) 部分。
NodeTool 支持运行 TypeScript DSL 工作流程，使用 nodetool workflows run my-workflow.ts 命令。具体工作流和模块说明，请参见 [WORKFLOW/MODULES](#workflow/modules) 部分。
NodeTool是专业级AI工作流平台，节点式设计易用高效，支持多模型集成和自动化编排。TypeScript实现确保稳定性，适合企业和开发者部署复杂AI应用。
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 做语音类 AI 产品的开发者
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- embedding 模型与查询模型不一致导致检索失效
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
- Docker：nodetool 提供官方镜像，docker compose up 一键启动
- CLI：直接 npm install -g / pip install，命令行调用
- 本地部署：CPU 8GB 起，GPU 推荐 16GB+ 显存
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 做语音类 AI 产品的开发者
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- embedding 模型与查询模型不一致导致检索失效
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
该工具使用 AGPL-3.0 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
⚠️ AGPL 3.0 — 最严格的 Copyleft，网络服务端使用也需开源，SaaS 使用受限。
经综合评估，nodetool Agent工作流 在Agent工作流赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | nodetool |
| 原始描述 | 开源AI工作流：The open creative AI workspace。⭐344 · TypeScript |
| Topics | AI工作流节点编辑器智能体自动化开源 |
| GitHub | https://github.com/nodetool-ai/nodetool |
| License | AGPL-3.0 |
| 语言 | TypeScript |
收录时间：2026-05-16 · 更新时间：2026-05-19 · License：AGPL-3.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。