Zelaxy

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 13 Open GitHub ↗

🌱 Open-source visual platform to build, run & ship AI agents and workflows — built-in RAG, real-time collaboration, self-hosted. No code required.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="apps/zelaxy/public/Zelaxy.png" alt="Zelaxy Logo" width="84" />

<h1 align="center">🌿 Zelaxy</h1>

 The open-source visual platform for building, running & shipping AI agents and workflows. 
 Drag blocks onto a canvas → wire agents, tools & logic → run with live streaming. No code required — fully extensible when you need it.

<a href="https://zelaxy.in">🌐 Website</a> ·
 <a href="https://docs.zelaxy.in">📚 Docs</a> ·
 <a href="#-quickstart">⚡ Quickstart</a> ·
 <a href="#-build-anything">🔬 Examples</a> ·
 <a href="#-why-zelaxy">🌸 Why Zelaxy</a> ·
 <a href="https://github.com/manu14357/Zelaxy/issues">🐛 Issues</a> ·
 <a href="#-contributing">🤝 Contributing</a>

⭐ If Zelaxy is useful to you, star the repo — it genuinely helps the project reach more builders.

---

## 🌱 What is Zelaxy?

**Zelaxy** is a visual operating system for AI work. You compose workflows on a canvas out of
**blocks** — AI agents, integrations, logic, loops, sub-workflows — connect them, and a real
execution engine runs the graph with **token-by-token LLM streaming**.

It looks like a flow builder. Under the hood it's a **concurrent, topological execution engine** with
parallel branches, loops, conditional routing, sub-workflows, built-in vector search (RAG), guardrails,
and multi-provider AI orchestration — the kind of thing you'd otherwise stitch together from a dozen
scripts and services.

| 🧩 **270+** blocks | 🔌 **245+** integrations | 🤖 **25+** AI providers | ⚡ **65+** triggers | 🧠 **RAG** built-in |
|:---:|:---:|:---:|:---:|:---:|

…and growing every week. 🌾

</div>

> **🍃 Build workflows, not glue code.** Drag three blocks onto the canvas, connect them, hit run.

---

## 🤖 Bring your own AI — 25+ providers, one canvas

Chain frontier labs, blazing-fast inference hosts, your own cloud, and local models — in a single pipeline.
Pick a model from a dropdown; Zelaxy handles each provider's API, auth, streaming, and quirks.

<div align="center">Frontier OpenAI · Anthropic · Google · xAI · DeepSeek · Mistral · Meta &nbsp;·&nbsp; Fast inference Groq · Cerebras · Fireworks · Together · Baseten &nbsp;·&nbsp; Your cloud Azure OpenAI · Azure Anthropic · Bedrock · Vertex AI &nbsp;·&nbsp; Open / self-hosted Ollama · vLLM · LiteLLM · OpenRouter · NVIDIA · Z.ai · MiMo · Sakana</div>

---

## 🔌 Connect everything — 245+ integrations

Every logo below is a real block you drag onto the canvas. Auth, API calls, and pagination are handled for you.

<div align="center">Browse the full, searchable catalog at <a href="https://docs.zelaxy.in/docs/tools">docs.zelaxy.in</a>. 🌻</div>

---

## 📑 Table of Contents

- [Why Zelaxy](#-why-zelaxy)
- [Features](#-features)
- [Build anything — example workflows](#-build-anything)
- [How it works](#-how-it-works)
- [Blocks & integrations](#-blocks--integrations)
- [Quickstart](#-quickstart)
- [Configuration](#-configuration)
- [Development](#-development)
- [Deployment](#-deployment)
- [Tech stack](#-tech-stack)
- [Contributing](#-contributing)
- [Sponsors](#-sponsors)
- [License](#-license)

---

## 🌸 Why Zelaxy

Most automation tools make you choose: **great integrations _or_ real AI _or_ open-source & self-host.**
Zelaxy is built to give you all three on one canvas.

|  | **Zelaxy** | n8n | Zapier | Flowise / Langflow |
|---|:---:|:---:|:---:|:---:|
| Open source & self-hostable | ✅ MIT | ⚠️ fair-code | ❌ SaaS only | ✅ |
| Visual canvas builder | ✅ | ✅ | ⚠️ linear | ✅ |
| AI-native (multi-provider LLMs) | ✅ **25+ providers** | ⚠️ add-on | ⚠️ limited | ✅ |
| Built-in RAG / vector search | ✅ pgvector | ⚠️ via nodes | ❌ | ✅ |
| Real-time multi-user collaboration | ✅ | ❌ | ❌ | ❌ |
| Live token streaming while running | ✅ | ❌ | ❌ | ⚠️ |
| Guardrails (PII, hallucination, schema) | ✅ | ❌ | ❌ | ⚠️ |
| Code when you need it (JS / HTTP / MCP) | ✅ | ✅ | ⚠️ | ⚠️ |
| SDKs (TypeScript + Python) & CLI | ✅ | ⚠️ | ❌ | ⚠️ |

**Zelaxy is right for you if you want to:**

- ⚡ Automate complex AI processes **without writing a custom backend**
- 🔀 Chain **multiple LLM providers** (OpenAI, Claude, Gemini, Groq, DeepSeek, Grok, Mistral, Ollama…) in one pipeline
- 🔍 **Visually debug** — see exactly which block produced which output, and how long it took
- 📚 Build **RAG pipelines** with vector search built in — upload, embed, and query from any block
- 🪝 Trigger from **Slack, GitHub, Gmail, Stripe, Telegram**, webhooks, or cron
- 🏠 **Self-host** an open-source platform you can extend with your own blocks and tools

---

## 🚀 Features

| 🧩 **270+ blocks** | 🔌 **245+ integrations** | ⚡ **Live streaming** |
|---|---|---|
| Agents, logic, routing, loops, parallel, sub-workflows, functions, guardrails & more. | Slack, Gmail, Jira, Notion, S3, Pinecone, Snowflake, Firecrawl, ElevenLabs… hundreds of actions. | Token-by-token LLM streaming. Watch the AI think in real time. |
| 🤖 **25+ AI providers** | 🧠 **Knowledge base (RAG)** | 🪝 **65+ triggers** |
| OpenAI, Claude, Gemini, Groq, DeepSeek, Grok, Cerebras, Mistral, NVIDIA, Bedrock, OpenRouter, Ollama, vLLM… | Semantic + hybrid vector search via pgvector (HNSW cosine). Upload docs, embed, query from any block. | Webhooks, cron, Slack, GitHub, Gmail, Stripe, Telegram, Teams, Outlook, WhatsApp & more. |
| 🛡️ **Guardrails** | 🤝 **ZelaxyArena copilot** | 🔄 **Real execution engine** |
| PII detection (Presidio), hallucination scoring (RAG + LLM), JSON-schema & regex validation. | An in-app AI that builds & edits workflows from plain English, runs tools, researches the web, and manages tables. | Concurrent topological DAG, parallel branches, `for`/`forEach`/`while` loops, conditional routing, sub-workflows. |
| 👥 **Real-time collaboration** | 🔐 **Self-hosted & secure** | 🧰 **SDKs + CLI** |
| Multi-user live editing over WebSockets — live cursors, presence, and per-operation permission checks. | Bring your own keys, database, and infra. Encrypted credentials. MIT licensed. | TypeScript SDK, Python SDK, and a `zelaxy` CLI for programmatic workflows. |

---

## 🔬 Build anything

Six real, end-to-end workflows you can rebuild in minutes — each is a full walkthrough in the
**[Guides →](https://docs.zelaxy.in/docs/guides)**.

### 🔭 Deep Research Agent
> Fans out to **web + academic search in parallel**, then an agent synthesizes a **cited brief** as structured JSON.

`🗨️ Chat` → `🔀 Parallel [ Tavily · ArXiv ]` → `🤖 Agent · synthesize + cite` → `📤 Response`

### 🎧 Customer Support Agent
> Classifies inbound email, drafts a **knowledge-grounded** reply, and escalates urgent cases — behind a **human approval** gate.

`📧 Gmail` → `🤖 Agent · classify` → `🧭 Router` → `🔴 urgent → Slack` · `🟢 normal → Knowledge + draft + 🙋 Human → Gmail` · `⚪ spam → stop`

### 📚 RAG Knowledge Agent
> Answers strictly from **your** documents via pgvector search, with a **hallucination guardrail** that blocks ungrounded replies.

`🗨️ Chat` → `🧠 Knowledge · vector search` → `🤖 Agent · answer from passages` → `🛡️ Guardrails · grounded?` → `📤 Response`

### ✍️ Multi-Agent Content Pipeline
> A **researcher → writer → editor** hand-off turns one topic into publish-ready copy via three specialized agents.

`📝 Topic` → `🔎 Researcher · Tavily tool` → `✍️ Writer · draft` → `🪄 Editor · fact-check` → `📤 Response`

### 🎯 Lead Enrichment Agent
> Turns a raw email into a **scored, enriched CRM record** — enrich, qualify with an agent, then branch on the score.

`🪝 Webhook` → `🔍 Hunter / Clay · enrich` → `🤖 Agent · score fit` → `🔀 Condition ≥ 70` → `✅ CRM write` · `❌ drop`

### 📅 Scheduled Report Agent
> On a **cron schedule**, pulls metrics, has an agent write a narrative summary, and delivers it to Slack every morning.

`⏰ Schedule · cron` → `📊 API / Supabase / Sheets` → `🤖 Agent · narrate` → `💬 Slack`

---

## 🛠 How it works

|  |  |
|---|---|
| **01 · Design** 🎨 | Drag blocks onto the canvas. Connect AI agents, APIs, databases, and services. |
| **02 · Trigger** 🪝 | Webhooks, cron schedules, or event-driven from Slack, GitHub, Gmail, Stripe & more. |
| **03 · Run & stream** ⚡ | Hit run. Watch blocks execute concurrently with real-time token streaming and per-block I/O. |

---

## 🧩 Blocks & integrations

<details>
<summary>Browse the block families (270+ blocks across these categories)</summary>

| Category | Examples |
|----------|----------|
| **AI & reasoning** | Agent (multi-provider LLM + tools), Evaluator, Router, Vision, Image Generator, Thinking, Translate, MCP |
| **Flow control** | Condition (expression or LLM-judge), Router (LLM picks a path), Switch, Loop (`for`/`forEach`/`while`), Parallel, Wait, Human-in-the-loop |
| **Data & I/O** | Function (JavaScript), API (HTTP), Response, Starter, Variables, Workflow (sub-flows) |
| **Knowledge & memory** | Knowledge base (RAG / pgvector), Memory (key-value), Table, Mem0, Zep |
| **Safety** | Guardrails — PII (Presidio), hallucination scoring, JSON-schema & regex validation |
| **Messaging** | Slack, Discord, Telegram, WhatsApp, Gmail, Outlook, Microsoft Teams, Twilio, SMTP |
| **Productivity** | Jira, Linear, Notion, Asana, Trello, Monday, Confluence, Airtable, Google Docs/Sheets/Calendar, Excel |
| **CRM & sales** | Salesforce, HubSpot, Pipedrive, Attio, Apollo, Clay, Zendesk, Gong |
| **Databases** | PostgreSQL, MySQL, MSSQL, MongoDB, Snowflake, Supabase, ClickHouse, BigQuery, Redis, Elasticsearch |
| **Vector & storage** | Pinecone, Qdrant, S3, Google Drive, OneDrive, SharePoint, Dropbox, Box |
| **Web & browser** | Firecrawl, Jina, Stagehand (browser automation), Apify, Bright Data, HTTP |
| **Search & research** | Exa, Tavily, Perplexity, Serper, Linkup, DuckDuckGo, Wikipedia, ArXiv |
| **Voice & media** | ElevenLabs, Twilio, YouTube, Spotify, Fireflies, Image Generator, Vision |
| **Dev & DevOps** | GitHub, GitLab, Sentry, Datadog, Vercel, Cloudflare, PagerDuty, Grafana |
| **Finance** | Stripe, Square, Brex, RevenueCat, Shopify |
| **Custom** | MCP servers, Function (JS), API (HTTP), Webhooks, sub-workflows |

</details>

Full, searchable reference at **[docs.zelaxy.in](https://docs.zelaxy.in)**.

---

## ⚡ Quickstart

Open source. Self-hosted. No account required.

```bash
git clone https://github.com/manu14357/Zelaxy.git
cd Zelaxy
bun install
cp apps/zelaxy/.env.example apps/zelaxy/.env.local
# Edit .env.local — set DATABASE_URL, auth secrets, and at least one LLM API key
cd apps/zelaxy && bunx drizzle-kit migrate && cd ../..
bun run dev:full
```

App runs at **http://localhost:3000**, docs at **http://localhost:3001**.

Prefer hosted? Try **[zelaxy.in](https://zelaxy.in)** · Docs: **[docs.zelaxy.in](https://docs.zelaxy.in)**

> **Requirements:** [Bun](https://bun.sh) ≥ 1.2 · [PostgreSQL 17](https://www.postgresql.org/) with [pgvector](https://github.com/pgvector/pgvector) · at least one LLM API key.

---

## 🔧 Configuration

| Variable | Description |
|----------|-------------|
| `DATABASE_URL` | PostgreSQL connection string (with pgvector) |
| `REDIS_URL` | Redis connection string (e.g. `rediss://…` from Upstash) |
| `BETTER_AUTH_URL` | App URL (e.g. `http://localhost:3000`) |
| `BETTER_AUTH_SECRET` | Auth secret (min 32 chars) |
| `ENCRYPTION_KEY` | 64-char hex string for AES-256 credential encryption |
| `INTERNAL_API_SECRET` | Internal app ↔ socket bridge secret (min 32 chars) |
| `NEXT_PUBLIC_APP_URL` | Public app URL |

**LLM providers** (add any): `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`

**Local models:** `OLLAMA_URL` (default `http://localhost:11434`), plus any OpenAI-compatible base URL (vLLM, LiteLLM, LM Studio).

---

## 💻 Development

```bash
bun run dev:full          # Full dev (app + websocket + docs)
bun run dev               # App only
bun run dev:sockets       # WebSocket server only
bun run build             # Build all
bun run test              # Run tests (~900 unit tests)
bun run lint              # Lint and auto-fix (Biome)
bun run type-check        # Type check (0 errors)
```

```bash
cd apps/zelaxy && bunx drizzle-kit studio    # Database GUI
cd apps/zelaxy && bunx drizzle-kit migrate   # Run migrations
bun run start:worker                          # Background job worker (requires REDIS_URL)
```

---

## 🌐 Deployment

The Next.js app deploys to **Vercel**. Two long-running services run on **Railway**:

| Service | Config file | Start command |
|---------|-------------|---------------|
| Socket server | `railway.json` | `bun run start:sockets` |
| Background worker | `railway-worker.json` | `bun run start:worker` |

Set `NEXT_PUBLIC_SOCKET_URL` and `SOCKET_SERVER_URL` on Vercel to your Railway socket URL. Background
jobs use **BullMQ** backed by **Redis** (Upstash recommended) — set `REDIS_URL` on both Vercel and the
Railway worker.

---

## 🧱 Tech stack

| Layer | Technology |
|-------|-----------|
| **Framework** | Next.js 15 (App Router, Turbopack) · React 19 |
| **Language** | TypeScript |
| **Runtime** | Bun |
| **Database** | PostgreSQL 17 + pgvector (Drizzle ORM) |
| **Auth** | better-auth (OAuth 2.0) |
| **UI** | Tailwind CSS + shadcn/ui (Radix) · @xyflow/react |
| **State** | Zustand · TanStack Query |
| **Real-time** | Socket.IO |
| **Background jobs** | BullMQ + ioredis (Redis) |
| **Monorepo** | Turborepo + Bun workspaces |
| **Testing** | Vitest |
| **Linter / formatter** | Biome |
| **Docs** | Fumadocs (MDX) |

---

## 🤝 Contributing

Contributions are welcome — blocks, integrations, bug fixes, docs, all of it. 🌱

1. Fork the repository
2. Create a feature branch (`git checkout -b feat/your-feature`)
3. Make your changes
4. Run `bun run test`, `bun run lint`, and `bun run type-check`
5. Open a pull request

New here? Look for [`good first issue`](https://github.com/manu14357/Zelaxy/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and read [CONTRIBUTING.md](CONTRIBUTING.md).

---

## 💖 Sponsors

Zelaxy is free and open source. Sponsors keep it that way. 🌻

| Tier | $/mo | Perks |
|------|------|-------|
| 💎 **Diamond** | $1,000 | Co-branding + monthly 1:1 + all below |
| 🏆 **Platinum** | $500 | Custom block icon in arena + all below |
| 🥇 **Gold** | $250 | Large logo everywhere + priority support |
| 🥈 **Silver** | $100 | Logo on README, website, docs + early access |
| 🥉 **Bronze** | $50 | Logo on README, website, and docs |
| 🙌 **Supporter** | $15 | Name + link on README, website, and docs |
| 💜 **Backer** | $5 | Name on README + website |

Your logo here — <a href="https://github.com/sponsors/manu14357">become a sponsor</a>

---

## 📄 License

---

⭐ Star Zelaxy to follow along — new blocks, integrations, and features ship constantly. 🌿

🌱 Built for people who want to automate with AI — not write glue code.

Zelaxy

Today's picks

Was this content helpful?

Recent Feedback

Zelaxy

Today's picks

Was this content helpful?

Recent Feedback

Download README