Vane Agent工作流
Vane Agent工作流 是 AI Skill Hub 本期精选Agent工作流之一。在 GitHub 上收获超过 34.4k 颗 Star，综合评分 8.2 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。
📚 深度解析
Vane Agent工作流 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.2 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
Vane Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
Vane Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g vane # 方式二：npx 直接运行（无需安装） npx vane --help # 方式三：项目依赖安装 npm install vane # 方式四：从源码运行 git clone https://github.com/ItzCrazyKns/Vane cd Vane npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
vane --help
# 基本用法
vane [options] <input>
# Node.js 代码中使用
const vane = require('vane');
const result = await vane.run(options);
console.log(result);
# vane 配置说明 # 查看配置选项 vane --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export VANE_CONFIG="/path/to/config.yml"
Vane 🔍
Vane is a privacy-focused AI answering engine that runs entirely on your own hardware. It combines knowledge from the vast internet with support for local LLMs (Ollama) and cloud providers (OpenAI, Claude, Groq), delivering accurate answers with cited sources while keeping your searches completely private.
Want to know more about its architecture and how it works? You can read it here.
✨ Features
🤖 Support for all major AI providers - Use local LLMs through Ollama or connect to OpenAI, Anthropic Claude, Google Gemini, Groq, and more. Mix and match models based on your needs.
⚡ Smart search modes - Choose Speed Mode when you need quick answers, Balanced Mode for everyday searches, or Quality Mode for deep research.
🧭 Pick your sources - Search the web, discussions, or academic papers. More sources and integrations are in progress.
🧩 Widgets - Helpful UI cards that show up when relevant, like weather, calculations, stock prices, and other quick lookups.
🔍 Web search powered by SearxNG - Access multiple search engines while keeping your identity private. Support for Tavily and Exa coming soon for even better results.
📷 Image and video search - Find visual content alongside text results. Search isn't limited to just articles anymore.
📄 File uploads - Upload documents and ask questions about them. PDFs, text files, images - Vane understands them all.
🌐 Search specific domains - Limit your search to specific websites when you know where to look. Perfect for technical documentation or research papers.
💡 Smart suggestions - Get intelligent search suggestions as you type, helping you formulate better queries.
📚 Discover - Browse interesting articles and trending content throughout the day. Stay informed without even searching.
🕒 Search history - Every search is saved locally so you can revisit your discoveries anytime. Your research is never lost.
✨ More coming soon - We're actively developing new features based on community feedback. Join our Discord to help shape Vane's future!
Upcoming Features
- [ ] Adding more widgets, integrations, search sources
- [ ] Adding ability to create custom agents (name T.B.D.)
- [ ] Adding authentication
Installation
There are mainly 2 ways of installing Vane - With Docker, Without Docker. Using Docker is highly recommended.
Getting Started with Docker (Recommended)
Vane can be easily run using Docker. Simply run the following command:
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latestThis will pull and start the Vane container with the bundled SearxNG search engine. Once running, open your browser and navigate to http://localhost:3000. You can then configure your settings (API keys, models, etc.) directly in the setup screen.
Note: The image includes both Vane and SearxNG, so no additional setup is required. The -v flags create persistent volumes for your data and uploaded files.
Using Vane with Your Own SearxNG Instance
If you already have SearxNG running, you can use the slim version of Vane:
docker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:slim-latestImportant: Make sure your SearxNG instance has:
- JSON format enabled in the settings
- Wolfram Alpha search engine enabled
Replace http://your-searxng-url:8080 with your actual SearxNG URL. Then configure your AI provider settings in the setup screen at http://localhost:3000.
Advanced Setup (Building from Source)
If you prefer to build from source or need more control:
- Ensure Docker is installed and running on your system.
- Clone the Vane repository:
git clone https://github.com/ItzCrazyKns/Vane.git
- After cloning, navigate to the directory containing the project files.
- Build and run using Docker:
docker build -t vane .
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vane
- Access Vane at http://localhost:3000 and configure your settings in the setup screen.
Note: After the containers are built, you can start Vane directly from Docker without having to open a terminal.
Non-Docker Installation
- Install SearXNG and allow
JSONformat in the SearXNG settings. Make sure Wolfram Alpha search engine is also enabled. - Clone the repository:
git clone https://github.com/ItzCrazyKns/Vane.git
cd Vane
- Install dependencies:
npm i
- Build the application:
npm run build
- Start the application:
npm run start
- Open your browser and navigate to http://localhost:3000 to complete the setup and configure your settings (API keys, models, SearxNG URL, etc.) in the setup screen.
Note: Using Docker is recommended as it simplifies the setup process, especially for managing environment variables and dependencies.
See the installation documentation for more information like updating, etc.
One-Click Deployment
Using Vane's API
Vane also provides an API for developers looking to integrate its powerful search engine into their own applications. You can run searches, use multiple models and get answers to your queries.
For more details, check out the full documentation here.
Troubleshooting
Local OpenAI-API-Compliant Servers
If Vane tells you that you haven't configured any chat model providers, ensure that:
- Your server is running on
0.0.0.0(not127.0.0.1) and on the same port you put in the API URL. - You have specified the correct model name loaded by your local LLM server.
- You have specified the correct API key, or if one is not defined, you have put something in the API key field and not left it empty.
Ollama Connection Errors
If you're encountering an Ollama connection error, it is likely due to the backend being unable to connect to Ollama's API. To fix this issue you can:
- Check your Ollama API URL: Ensure that the API URL is correctly set in the settings menu.
- Update API URL Based on OS:
- Windows: Use
http://host.docker.internal:11434 - Mac: Use
http://host.docker.internal:11434 - Linux: Use
http://<private_ip_of_host>:11434
Adjust the port number if you're using a different one.
- Linux Users - Expose Ollama to Network:
- Inside
/etc/systemd/system/ollama.service, you need to addEnvironment="OLLAMA_HOST=0.0.0.0:11434". (Change the port number if you are using a different one.) Then reload the systemd manager configuration withsystemctl daemon-reload, and restart Ollama bysystemctl restart ollama. For more information see Ollama docs
- Ensure that the port (default is 11434) is not blocked by your firewall.
Lemonade Connection Errors
If you're encountering a Lemonade connection error, it is likely due to the backend being unable to connect to Lemonade's API. To fix this issue you can:
- Check your Lemonade API URL: Ensure that the API URL is correctly set in the settings menu.
- Update API URL Based on OS:
- Windows: Use
http://host.docker.internal:8000 - Mac: Use
http://host.docker.internal:8000 - Linux: Use
http://<private_ip_of_host>:8000
Adjust the port number if you're using a different one.
- Ensure Lemonade Server is Running:
- Make sure your Lemonade server is running and accessible on the configured port (default is 8000).
- Verify that Lemonade is configured to accept connections from all interfaces (
0.0.0.0), not just localhost (127.0.0.1). - Ensure that the port (default is 8000) is not blocked by your firewall.
高活跃度开源项目，完整的工作流和AI代理支持，TypeScript实现便于集成扩展。生态完善，适合企业级应用构建。
- 构建多智能体协作系统的 Agent 开发者
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
- Docker：Vane 提供官方镜像，docker compose up 一键启动
- CLI：直接 npm install -g / pip install，命令行调用
- 本地部署：CPU 8GB 起，GPU 推荐 16GB+ 显存
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 构建多智能体协作系统的 Agent 开发者
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +GitHub 34.4k Star，社区高度认可
- +MIT 协议，可免费商用
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
经综合评估，Vane Agent工作流 在Agent工作流赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | Vane |
| 原始描述 | 开源AI工作流：Vane is an AI-powered answering engine.。⭐34.4k · TypeScript |
| Topics | AI工作流问答引擎AI代理搜索引擎LLM应用 |
| GitHub | https://github.com/ItzCrazyKns/Vane |
| License | MIT |
| 语言 | TypeScript |
收录时间：2026-05-14 · 更新时间：2026-05-16 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。