AgentSwarms – self-hostable agentic AI/BI platform with sandboxed Python (ELv2)

Deploy your own agentic AI & business-intelligence platform.

Build agents, run multi-agent swarms, ground them in your data, and inspect every trace — on your own infrastructure, with your own keys.

Screenshots · Features · Quickstart · Documentation · Self-host vs. hosted · Contributing

AgentSwarms is a complete, self-hostable, source-available agentic AI & business-intelligence platform: agent chat, a visual multi-agent swarm canvas, knowledge bases with RAG, tool use, MCP connections, connected databases & warehouses, dashboards, budgets, and full execution traces. It is designed for easy deployment: one Supabase project as the backend, one Docker command to run, and bring-your-own-everything — your data lives in your own Supabase project, and models run against your own provider keys (OpenRouter, OpenAI, Anthropic, Gemini, Bedrock, Azure, OCI, Qwen, Grok, Groq, Ollama, vLLM…). Optionally set one instance-wide OpenRouter key so every user on your instance can start with zero setup.

Swarm canvas — design a multi-agent workflow as a graph and run it end to end. Each node is a step (agent, router, condition, loop, approval, tool call); the inspector sets its provider, model, prompt, tools and knowledge. The same graph runs from the canvas, from the API and on a schedule.

BI Workspace — multi-page dashboards over your connected tables and warehouses, with KPIs, cross-filtering, scheduled refresh, PDF export and publish-and-share links.

Agent Chat, with Visual BI — ask a question in plain language and get a chart computed from your own data beside the answer. The SQL that produced it is shown as the source, so the number is checkable rather than asserted.

Agent Chat, generating documents — turn the conversation and your data into a real, editable PowerPoint, Word document or Excel workbook. The Excel can pull every row with live formulas rather than a pasted snapshot.

Developer workspace — Python notebooks on sandboxed server kernels with real langchain

, langgraph

and llama_index

installed. Model and knowledge-base calls are brokered by the platform, so no provider key ever exists inside the sandbox. Notebooks can call your deployed agents, and can themselves be published as callable APIs.

Same UI, two different missions:

This repository (source-available, Elastic License 2.0) | | | |---|---|---| Focus | Easy deployment of the full agentic AI & BI platform on your own infrastructure — agents, swarms, RAG, connected data, dashboards, traces, budgets. | Learning first: a hands-on classroom for agentic AI — guided curriculum, build-along labs, interactive notebooks, presentations, and certification — fully managed. | Runs on | Your Supabase project, your provider keys, your Docker host (or Cloudflare Workers). | Managed infrastructure, including an AI gateway with free-tier models — nothing to configure. | Extras | Headless control of your own data; no usage caps other than your own budgets. | Hosted-only surfaces: field-engineering blog, community galleries, voice agents, website embeds, and free standalone tools. | Best for | Teams and tinkerers who want to run an agentic AI platform they own. | Learners who want to study and practice agentic AI without setting anything up. |

The "AgentSwarms" name and the hosted service remain with the project author.

🤖 Agent Chat | Build an agent, wire up tools, and chat with it in-browser (under Build → Agent Chat), with full request/response traces. Flip on Visual BI to render a chart from your connected tables next to the answer, and generate a fully-editable PowerPoint, Word or Excel from your prompt + the conversation — the Excel can pull all rows with live formulas. See . | 🐝 Swarm canvas | Design multi-agent workflows visually (built on checkpoint as they go, so a run survives a restart or deploy, and a human-approval step parks the run until someone decides rather than rubber-stamping it or failing. |

Knowledge Base / RAGData SourcesPostgreSQL(Supabase, RDS, Neon…),** MySQL/MariaDB**,** Oracle**(Autonomous DB / ORDS), Amazon Redshift, Snowflake, Databricks, Google BigQuery, Azure Synapse,** Trino / Starburst / Presto**, and** Amazon Athena**— encrypted credentials, read-only. Query them from the Data Catalog SQL workbench, from SQL agents, and feed BI charts, ontologies and scheduled refreshes. See**.Data sources & connectors Secrets Manager**{{secret:NAME}}

— warehouse connections, provider keys. Superadmins share secrets with users/groups via IAM.Data Catalog****Iceberg REST catalog through a wizard; the crawler lists every table and object, groups partitioned folders into datasets, infers CSV/JSON schemas by sampling, profiles columns (null %, distinct counts, ranges), estimates row counts, and flags likely-PII columns. Schedule daily/weekly incremental crawls with schema-drift notifications, generate asset + column documentation with AI, certify or deprecate assets with owners and tags, trace lineage and usage (which dashboards, prep flows and metrics consume each table), define a business glossary, and jump straight into the SQL workbench.Business Intelligence****workspaces & folders with read-only group sharing,promote a personal draft into a shared workspace, andexport model/dashboard definitions to aGit repo (GitHub/GitLab).Observability****Web search & browsingweb_search

and web_browse

tools. Works out of the box with no key(free DuckDuckGo fallback — limited); for real workspace-wide search + full-page reads, connect** Firecrawl**on the Integrations page (or setFIRECRAWL_API_KEY

), or bring your own Brave / SerpAPI / Tavily / ScrapingBee key per agent. Every model-driven fetch is SSRF-guarded. See**.Web search & browsing BYOK + MCP + A2AMCP BuilderFastMCP** underBuild → MCP Builder, deploy it to the same sandboxed kernel the Developer workspace uses, and get a real Streamable-HTTP endpoint. It scales to zero by default (or stays warm), registers itself so your own agents can call it, and can beexposed publicly with hashed API keys that support expiry, per-tool and per-IP limits. Secrets bind as environment variables without ever entering the container environment, and a redeploy that changes any tool name, description or schemablocks calls until you re-approve— the anti "rug pull" control MCP's own security guidance asks for. Needs the server runtime enabled.** IAMDeveloper workspacesandboxed server kernels**— real CPython with workingpip install

and genuine LangChain,** LangGraphand LlamaIndex**imports, not a browser emulation. Ships with read-only, runnable samples for each plus a mixed agentic-stack capstone (knowledge base, tools, skills, guardrails, MCP) — fork any of them to edit. The built-inagentswarms

helper calls your connected models, searches your knowledge base and runs your saved agents and swarms, all governed by IAM rules and logged in Traces — no provider key ever exists inside the sandbox. A notebook can also bepublished as a callable API, and versioned to Git as plain Python. Operators enable the runtime under** Admin → Developer runtime**; see**.the runtime guide Guardrails & evals****One-command setup** — after you've created a Supabase project and put its keys in .env

(see below), a script handles the rest (secrets, deps, migrations, and bringing up the stack):

cp .env.example .env      # fill in your Supabase keys, then:
bash scripts/setup.sh                 # Docker stack  →  http://localhost:8080

Or do it by hand — there is no separate backend to install, since Supabase is the backend (Postgres + Auth + Storage), run as a free-tier hosted project rather than installing anything yourself:

git clone https://github.com/AgentSwarms-fyi/agentswarms.git
cd agentswarms
npm install
cp .env.example .env   # fill in your Supabase + provider keys
npm run dev            # → http://localhost:8080

Self-host with Docker (any Node-capable host — VPS, Fly, Railway, Render, K8s):

cp .env.example .env   # fill in Supabase + keys, apply migrations once
docker compose up --build

First time? Follow ** the full installation guide** — it covers every step on macOS, Linux, and Windows, including the Supabase dashboard clicks and a troubleshooting section for the errors people actually hit.

The docs live in docs/, one focused guide per topic:

Contributions are welcome — see ** CONTRIBUTING.md** for the workflow, and please read the

first.

Code of ConductFound a vulnerability? Please see ** SECURITY.md** for how to report it responsibly instead of opening a public issue.

AgentSwarms is source-available under the ** Elastic License 2.0** (ELv2). In plain terms: you may freely

use, self-host, modify, and redistribute it — but you may

not offer it to third parties as a hosted or managed service, and you may not remove the licensing/copyright notices. A separate

commercial license is available from the author for use cases ELv2 doesn't permit (including running it as a SaaS) — reach out if that's you.

The "AgentSwarms" name, logo, and the hosted service are trademarks of the project author and are not licensed for your use; ELv2 covers the code, not the brand.

Every direct dependency uses a permissive license (MIT / Apache-2.0 / ISC / BSD), compatible with redistribution under ELv2 — the full audit and credits for the open-source projects AgentSwarms builds on live in ** ACKNOWLEDGEMENTS.md**.

Built with TanStack Start and Supabase — an agentic AI & BI platform you own.