Skip to content
manu14357Public

About

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

Topics

Resources

Contributing

Stars

15 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

303 Commits

Folders and files

Repository files navigation

Zelaxy Logo

🌿 Zelaxy

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.

🌐 Website Β· πŸ“š Docs Β· ⚑ Quickstart Β· πŸ”¬ Examples Β· 🌸 Why Zelaxy Β· πŸ› Issues Β· 🀝 Contributing

CI License: MIT GitHub Stars Last commit PRs welcome

Next.js 15 React 19 TypeScript Bun PostgreSQL + pgvector

⭐ 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. 🌾

πŸƒ 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.

OpenAI Anthropic Google Gemini xAI DeepSeek Mistral Meta

Groq Cerebras NVIDIA AWS Bedrock Azure Ollama Hugging Face OpenRouter vLLM

Frontier OpenAI Β· Anthropic Β· Google Β· xAI Β· DeepSeek Β· Mistral Β· Meta Β Β·Β  Fast inference Groq Β· Cerebras Β· Fireworks Β· Together Β· Baseten Β Β·Β  Your cloud Azure OpenAI Β· Azure Anthropic Β· Bedrock Β· Vertex AI Β Β·Β  Open / self-hosted Ollama Β· vLLM Β· LiteLLM Β· OpenRouter Β· NVIDIA Β· Z.ai Β· MiMo Β· Sakana

πŸ”Œ 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.

Slack Gmail Discord Telegram WhatsApp Teams Twilio Notion

GitHub GitLab Jira Linear Asana Airtable Confluence Sentry

Salesforce HubSpot Stripe Shopify Google Sheets Google Drive Dropbox S3

PostgreSQL MongoDB Snowflake Supabase Pinecone Qdrant Redis Elasticsearch

ElevenLabs YouTube Reddit X Cloudflare Vercel Firecrawl and more

Browse the full, searchable catalog at docs.zelaxy.in. 🌻

πŸ“‘ Table of Contents


🌸 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 β†’.

πŸ”­ 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

Browse the block families (270+ blocks across these categories)
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

Full, searchable reference at docs.zelaxy.in.


⚑ Quickstart

Open source. Self-hosted. No account required.

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 Β· Docs: docs.zelaxy.in

Requirements: Bun β‰₯ 1.2 Β· PostgreSQL 17 with 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

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)
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 and read CONTRIBUTING.md.


πŸ’– Sponsors

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

Sponsor Zelaxy

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 β€” become a sponsor


πŸ“„ License

MIT Β© 2025 Zelaxy β€” see 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.

About

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

Topics

Resources

Contributing

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages