Zelaxy

KO | EN

gitlite — search

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

(★ 13)

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

Zelaxy Latest Version Download

Download Latest Version (.zip)

// 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

Zelaxy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Zelaxy

Zelaxy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README