Zelaxy

align="center"> <img src="apps/zelaxy/public/Zelaxy.png" alt="Zelaxy Logo" width="84" /> </p> <h1 align="center">Zelaxy</h1> <p align="center"> <b>用于构建、运行和交付 AI 代理和工作流的开源可视化平台。</b><br/> _{将积木块拖放到画布上 → 连接代理、工具和逻辑 → 运行并实时流式传输。无需代码 — 需要时完全可扩展。} </p> <p align="center"> <img src="apps/zelaxy/app/(landing)/assets/Readme.png" alt="Zelaxy — visual AI workflow builder" width="100%" /> </p> <p align="center"> <a href="https://zelaxy.in"><b>官网</b></a> · <a href="https://docs.zelaxy.in"><b>文档</b></a> · <a href="#-quickstart"><b>快速入门</b></a> · <a href="#-why-zelaxy"><b>为什么选择 Zelaxy</b></a> · <a href="https://github.com/manu14357/Zelaxy/issues"><b>问题</b></a> · <a href="#-contributing"><b>贡献</b></a> </p> <p align="center"> <a href="https://github.com/manu14357/Zelaxy/actions/workflows/ci.yml"><img src="https://github.com/manu14357/Zelaxy/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="https://github.com/manu14357/Zelaxy/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a> <a href="https://github.com/manu14357/Zelaxy/stargazers"><img src="https://img.shields.io/github/stars/manu14357/Zelaxy?style=flat&logo=github&color=EA580C" alt="GitHub Stars" /></a> <a href="https://github.com/manu14357/Zelaxy/commits/main"><img src="https://img.shields.io/github/last-commit/manu14357/Zelaxy?color=EA580C" alt="Last commit" /></a> <a href="https://github.com/manu14357/Zelaxy/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome" /></a> </p> <p align="center"> <img src="https://img.shields.io/badge/Next.js-15-000000?logo=nextdotjs&logoColor=white" alt="Next.js 15" /> <img src="https://img.shields.io/badge/React-19-149ECA?logo=react&logoColor=white" alt="React 19" /> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white" alt="TypeScript" /> <img src="https://img.shields.io/badge/Bun-1.2-000000?logo=bun&logoColor=white" alt="Bun" /> <img src="https://img.shields.io/badge/PostgreSQL-pgvector-4169E1?logo=postgresql&logoColor=white" alt="PostgreSQL + pgvector" /> </p> <p align="center"> <b>⭐ 如果 Zelaxy 对您有帮助，请给仓库点赞 — 这真的有助于项目被更多开发者发现。</b> </p> --- ## 什么是 Zelaxy？ **Zelaxy** 是一个用于 AI 工作流的可视化操作系统。您可以在画布上通过**积木块**组成工作流 — AI 代理、集成、逻辑、循环、子工作流 — 连接它们，执行引擎便会以**逐令牌的 LLM 流式传输**运行图形。 它看起来像一个流程构建器。在底层，它是一个具有并行分支、循环、条件路由、子工作流、内置向量搜索（RAG）和多提供商 AI 协调的**拓扑执行引擎** — 这是您通常需要使用十几个脚本和服务才能实现的东西。 <div align="center"> | 🧩 **264** 积木块 | 🔌 **240+** 集成 | 🤖 **21** AI 提供商 | ⚡ **30+** 触发器 | 🧠 **RAG** 内置 | |:---:|:---:|:---:|:---:|:---:| </div> > **构建工作流，而不是胶水代码。** 将三个积木块拖放到画布上，连接它们，然后点击运行。 --- ## 目录 - [为什么选择 Zelaxy](#-why-zelaxy) - [功能](#-features) - [工作原理](#-how-it-works) - [积木块和集成](#-blocks--integrations) - [快速入门](#-quickstart) - [配置](#-configuration) - [开发](#-development) - [部署](#-deployment) - [技术栈](#-tech-stack) - [项目结构](#-project-structure) - [贡献](#-contributing) - [赞助](#-sponsors) - [许可证](#-license) --- ## ✨ 为什么选择 Zelaxy 大多数自动化工具都要求您选择：**优秀的集成** 或 **真正的人工智能** 或 **开源和自托管**。Zelaxy 旨在为您提供这三者。 | | **Zelaxy** | n8n | Zapier | Flowise / Langflow | |---|:---:|:---:|:---:|:---:| | 开源和自托管 | ✅ MIT | ⚠️ 合理代码 | ❌ SaaS 仅限 | ✅ | | 可视化画布构建器 | ✅ | ✅ | ⚠️ 线性 | ✅ | | AI 原生（多提供商 LLM） | ✅ **21 提供商** | ⚠️ 附加组件 | ⚠️ 有限 | ✅ | | 内置 RAG / 向量搜索 | ✅ pgvector | ⚠️ 通过节点 | ❌ | ✅ | | 实时多人协作 | ✅ | ❌ | ❌ | ❌ | | 运行时的实时令牌流式传输 | ✅ | ❌ | ❌ | ⚠️ | | 护栏（PII、幻觉、模式） | ✅ | ❌ | ❌ | ⚠️ | | 需要代码时（JS / HTTP / MCP） | ✅ | ✅ | ⚠️ | ⚠️ | | SDK（TypeScript + Python）和 CLI | ✅ | ⚠️ | ❌ | ⚠️ | **Zelaxy 适合您，如果您想：** - ⚡ **自动化复杂的人工智能流程**，而无需编写自定义后端 - 🔀 **链接多个 LLM 提供商**（OpenAI、Claude、Gemini、Groq、DeepSeek、Grok、Mistral、Ollama...）在一个管道中 - 🔍 **可视化调试** — 精确查看哪个积木块产生了哪个输出，以及耗时多久 - 📚 **构建 RAG 管道**，并内置向量搜索 — 上传、嵌入并从任何积木块中查询 - 🪝 **从 Slack、GitHub、Gmail、Stripe、Telegram** 等触发 - 🏠 **自托管** 开源平台，您可以用自己的积木块和工具扩展它 --- ## 🚀 功能 | 🧩 **264 积木块** | 🔌 **240+ 集成** | ⚡ **实时流式传输** | |---|---|---| | 代理、逻辑、路由、循环、并行、子工作流、函数、护栏等。 | Slack、Gmail、Jira、NotS3、Pinecone、Snowflake、rawl、ElevenLabs... **880+ 操作 | 逐令 LLM 流式传输观看 AI 的思考过程。 | | 🤖 AI 提供商** | 🧠 **知识库（RAG）** | 🪝 **30触发器** | | OpenAI、Claude、、Groq、、Grok、C、Mistral、NVIDIA、Bedrock、OpenRouter、Ollama、vLLM、LM Studio... | 通过 pgvector 进行向量搜索。上传文档，嵌入并从任何积木块中查询。 | Webcron、Slack、GitHub、Gmail、Stripe、Teams、Outlook、WhatsApp 等。 | 🛡️ **护栏** | 🤝 **AI 副驾驶 + Wand** | 🔄 **实时执行 | | PII 检测、幻觉检查、JSON 模式验证。内置安全。 | RAG 驱动的助手，生成代码、模式和提示语言“Wand”编辑。 | 拓、并行分支、`forEach` / `循环、条件路由、子工作流| 👥 **** | 🔐 **和安全** | 🧰 **SDK** | | 通过 WebSockets 进行多人实时编辑，实时权限检查。 | 自带密钥、自带数据库、自带基础设施。MIT 许可。 | TypeScript SDK、Python SDK 和用于编程工作流的 CLI。 | --- ## 🛠 工作原理 | | | | |---|---|---| | **01 · 设计** | 将积木块拖放到画布上。连接 AI 代理、API、服务。 | | **02 · 触发** | Webhooks、cron 时间表或来自 Slack、GitHub、Stripe 等的事件驱动。 | 🪝 **03 · 运行和流式传输** |实时令牌流式传输和每个积输入/输出。 | ⚡ | --- ## 🧩 积木块和集成 <details> ><b>浏览积木块类别</b>（264 个积木块，涵盖以下类别）</summary> | 类别 | 示例 | |----------|----------| | **AI 代理** | OpenAI、Claude、Gemini、Groq、DeepGrok、Cerebras、HuggingFaceplexity、Mistral、Thinking、Vision核心逻辑** | 条件、路由器、开关、评估器、函数、API、循环、并行、等待、响应、人工干预 | | **消息 Slack、Discord、Telegram、WhatsApp、Outlook、Microsoft Teams、SMTP | | **生产力** | Jira、Notion、Google Docs、Google Calendar、Google Sheets、Excel、Planner、Confluence、Airtable、Asana | | **数据和搜索** | Pinecone、Qdrant、Supabase、Wikipedia、ArXiv、Reddit、Serper、Tavily、Exa、Linkup | | **存储** | S3、Google Drive、OneDrive、SharePoint、Dropbox、Box | | **数据库** | Snowflake、MSSQL、Postgres、Google Sheets、Excel | | **Web 和浏览器** | Firecrawl、Jina、Stagehand（浏览器自动化）、HTTP | | **语音和媒体** | ElevenLabs、Twilio SMS、Translate、Image Generator、YouTube、Vision | | **知识和内存** | 知识库（RAG）、内存（键值存储）、Mem0 | | **安全** | 护栏 — PII 检测、幻觉检查、JSON 模式验证 | | **自定义** | MCP 服务器、函数（JavaScript）、API（HTTP）、Webhooks、工作流（子流程） | </details> 在 **[docs.zelaxy.in](https://docs.zelaxy.in)** 上查看完整的可搜索引用。 --- ## ⚡ 快速入门 开源。自托管。无需账号。 ```bash git clone https://github.com/manu14357/Zelaxy.git cd Zelaxy bun install cp apps/zelaxy/.env.example apps/zelaxy/.env.local # 编辑 .env.local — 设置 DATABASE_URL、身份验证密钥和至少一个 LLM API 密钥 cd apps/zelaxy && bunx drizzle-kit migrate && cd ../.. bun run dev:full ``` 应用运行在 **http://localhost:3000**，文档运行在 **http://localhost:3001**。 更喜欢托管服务？尝试 **[zelaxy.in](https://zelaxy.in)** · 文档：**[docs.zelaxy.in](https://docs.zelaxy.in)** > **要求：** [Bun](https://bun.sh) ≥ 1.2 · [PostgreSQL 17](https://www.postgresql.org/) 搭配 [pgvector](https://github.com/pgvector/pgvector) · 至少一个 LLM API 密钥。 --- ## 🔧 配置 | 变量 | 描述 | |----------|-------------| | `DATABASE_URL` | PostgreSQL 连接字符串 | | `REDIS_URL` | Redis 连接字符串（例如 `rediss://…` 来自 Upstash） | | `BETTER_AUTH_URL` | 应用 URL（例如 `http://localhost:3000`） | | `BETTER_AUTH_SECRET` | 身份验证密钥（最小 32 个字符） | | `ENCRYPTION_KEY` | 64 个字符的十六进制字符串，用于 AES-256 | | `INTERNAL_API_SECRET` | 内部 API 密钥（最小 32 个字符） | | `NEXT_PUBLIC_APP_URL` | 公共应用 URL | **LLM 提供商** （添加任意）：`OPENAI_API_KEY`、`ANTHROPIC_API_KEY`、`GOOGLE_API_KEY`、`GROQ_API_KEY`、`DEEPSEEK_API_KEY`、`XAI_API_KEY`、`CEREBRAS_API_KEY`、`NVIDIA_API_KEY`、`MISTRAL_API_KEY`、`OPENROUTER_API_KEY` **本地模型：** `OLLAMA_URL`（默认为 `http://localhost:11434`）、`LM_STUDIO_URL`（默认为 `http://localhost:1234`） --- ## 💻 开发 ```bash bun run dev:full # 完整开发（应用 + WebSocket + 文档） bun run dev # 仅应用 bun run dev:sockets # 仅 WebSocket 服务器 bun run build # 构建所有 bun run test # 运行测试（~900 个单元测试） bun run lint # 校验和自动修复（Biome） bun run type-check # 类型检查（0 错误） ``` ```bash cd apps/zelaxy && bunx drizzle-kit studio # 数据库 GUI cd apps/zelaxy && bunx drizzle-kit migrate # 运行迁移 bun run start:worker # 后台作业工作线程（需要 REDIS_URL） ``` --- ## 🌐 部署 Next.js 应用部署到 **Vercel**。两个长期运行的服务运行在 **Railway** 上： | 服务 | 配置文件 | 启动命令 | |---------|-------------|---------------| | WebSocket 服务器 | `railway.json` | `bun run start:sockets` | | 后台工作线程 | `railway-worker.json` | `bun run start:worker` | 在 Vercel 上设置 `NEXT_PUBLIC_SOCKET_URL` 和 `SOCKET_SERVER_URL` 为您的 Railway WebSocket URL。后台作业使用 **BullMQ** 支持的 **Redis**（推荐 Upstash）— 在 Vercel 和 Railway 工作线程上设置 `REDIS_URL`。 --- ## 🧰 技术栈 | 层 | 技术 | |-------|-----------| | **框架** | Next.js 15（应用路由器，Turbopack）· React 19 | | **语言** | TypeScript | | **运行时** | Bun | | **数据库** | PostgreSQL 17 + pgvector（Drizzle ORM） | | **身份验证** | better-auth（OAuth 2.0） | | **UI** | Tailwind CSS + shadcn/ui（Radix）· @xyflow/react | | **状态** | Zustand · TanStack Query | | **实时** | Socket.IO | | **后台作业** | BullMQ + ioredis（Redis） | | **单体仓库** | Turborepo + Bun 工作区 | | **测试** | Vitest | | **校验 / 格式化** | Biome | | **文档** | Fumadocs（MDX） | --- ## 📁 项目结构 ``` Zelaxy/ ├── apps/ │ ├── zelaxy/ # 主要的 Next.js 15 应用（产品） │ │ ├── app/ # 应用路由器 — 页面（/arena/**）、API 路由（/api/**） │ │ ├── blocks/ # 264 个积木块定义 + 注册表 │ │ ├── tools/ # 240+ 集成（880+ 操作）+ 注册表 │ │ ├── executor/ # 工作流执行引擎（DAG、解析器、处理程序） │ │ ├── providers/ # 21 个 LLM 提供商 │ │ ├── triggers/ # Webhook / 时间表 / 事件触发器 │ │ ├── serializer/ # 编辑器图 → 可执行工作流 │ │ ├── db/ # Drizzle ORM 模式 + 查询 │ │ ├── stores/ # Zustand 状态 │ │ ├── socket-server/# Socket.IO 实时协作服务器 │ │ └── worker/ # 后台作业 │ ├── docs/ # 文档站点（Fumadocs） │ └── core/ # 共享核心 ├── packages/ # CLI · TypeScript SDK · Python SDK ├── LICENSE # MIT └── package.json # 仓库根目录 ``` 如果在代码库中工作，请从 [CLAUDE.md](CLAUDE.md) 和 [CONTRIBUTING.md](CONTRIBUTING.md) 开始。 --- ## 🤝 贡献 欢迎贡献 — 积木块、集成、错误修复、文档等。 1. 复刻仓库 2. 创建一个功能分支（`git checkout -b feat/your-feature`） 3. 进行更改 4. 运行 `bun run test`、`bun run lint` 和 `bun run type-check` 5. 打开一个拉取请求 新来者？寻找 [`good first issue`](https://github.com/manu14357/Zelaxy/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 并阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。 --- ## 💖 赞助 Zelaxy 免费且开源。赞助商让它保持这种状态。 <p align="center"> <a href="https://github.com/sponsors/manu14357"><img src="https://img.shields.io/badge/Sponsor%20Zelaxy-%E2%9D%A4-ea4aaa?style=for-the-badge&logo=github-sponsors" alt=" Zelaxy" /></a> </p> | 等级 | $/月权益 | |------|------|------- 💎 **钻石** |,000 | 品牌共建 + 每月 1:1 + 以下所有权益 | | 🏆 **白金** | $500 | 竞争者图标在 arena 中 + 以下所有权益 | | 🥇 **黄金** | $250 | 在所有地方显示大徽标 + 以下所有权益 | | 🥈 **白银** | $100 | 在 README、网站、文档中显示徽标 + 提前访问 | | 🥉 **青铜** | $50 | 在 README、网站和文档中显示徽标 | | 🙌 **支持者** | $15 | 在 README、网站和文档中显示姓名和链接 | 💜 **赞助者** | $5 | 在 README + 网站上显示姓名 | | <!-- SPONSORS:START --> <p align="center"> <em>您的徽标在这里 — <a href="https://github.com/sponsors/manu14357">成为赞助者</a></em> </p> <!-- SPONSORS:END --> --- ## 📄 许可证 MIT © 2025 Zelaxy — 查看 [LICENSE](LICENSE)。 --- <p align="center"> <b>⭐ Star Zelaxy 以关注</b> — 新的积木块、集成和功能不断发布。 </p> <p align="center"> <a href="https://star-history.com/#manu14357/Zelaxy&Date"> <img src="apps/zelaxy/public/social/star-history.png"Zelaxy Star History Chart" width="640" /> </a> </p> <p align="center"> _{为那些希望自动化 AI 而不是编写胶水代码的人而构建。} </p>