xpander.ai is the runtime and control plane to build, run, and ship reliable AI agents fast and anywhere
$git clone https://github.com/xpander-ai/xpander.aiInstalls into the current project.
Install xpander.ai by running `git clone https://github.com/xpander-ai/xpander.ai`, then use it for the current task and follow its documentation at https://github.com/xpander-ai/xpander.ai.
| 1 | <h3 align="center"> |
| 2 | <a name="readme-top"></a> |
| 3 | <picture> |
| 4 | <source media="(prefers-color-scheme: dark)" srcset="images/Purple%20Logo%20White%20text.png"> |
| 5 | <img |
| 6 | src="images/Purple%20Logo%20Black%20Text.png" |
| 7 | style="max-width: 100%; height: auto; width: auto; max-height: 170px;" |
| 8 | alt="xpander.ai Logo" |
| 9 | > |
| 10 | </picture> |
| 11 | </h3> |
| 12 | |
| 13 | <div align="center"> |
| 14 | <h3> |
| 15 | <font size="7">⚡️ Build, run, and ship agents — any framework, anywhere</font> |
| 16 | </h3> |
| 17 | <p> |
| 18 | 💬 Chat • 🧪 Workbench • 🏗️ AgentOS • 🗄️ DB • 🚦 CI/CD • 🔐 Self-Hosted • 🧑💻 Full code access |
| 19 | </p> |
| 20 | </div> |
| 21 | |
| 22 | <div align="center"> |
| 23 | <a href="https://pepy.tech/projects/xpander-sdk"><img src="https://static.pepy.tech/badge/xpander-sdk/month" alt="xpander-sdk downloads"></a> |
| 24 | <a href="https://github.com/xpander-ai/xpander.ai/blob/main/LICENSE"><img src="https://img.shields.io/github/license/xpander-ai/xpander.ai" alt="License"></a> |
| 25 | <a href="https://pypi.org/project/xpander-sdk"><img src="https://img.shields.io/pypi/v/xpander-sdk" alt="PyPI Version"></a> |
| 26 | <a href="https://npmjs.com/package/xpander-sdk"><img src="https://img.shields.io/npm/v/xpander-sdk" alt="NPM Version"></a> |
| 27 | <a href="https://app.xpander.ai"><img src="https://img.shields.io/badge/platform-login-30a46c" alt="Platform Login"></a> |
| 28 | </div> |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | <div align="center"> |
| 33 | <a href="https://chat.xpander.ai">Chat</a> |
| 34 | • <a href="https://docs.xpander.ai">Docs</a> |
| 35 | • <a href="https://docs.xpander.ai/Examples">Examples</a> |
| 36 | • <a href="https://xpander.ai">Website</a> |
| 37 | </div> |
| 38 | |
| 39 | --- |
| 40 | |
| 41 | xpander.ai is the runtime and control plane to build, run, and ship reliable AI agents fast. Start in Chat to use your agents immediately. Deploy Managed Agents (serverless) or Embedded Agents (containers). Add tools in Workbench. Run in xpander cloud or your own VPC/Kubernetes. Every agent gets a stateful DB, CI/CD, and logs — with full code access. Works with any framework. |
| 42 | |
| 43 | ## 🧰 The xpander.ai Platform (at a glance) |
| 44 | |
| 45 | 💬 Chat (chat.xpander.ai) — Generalist AI agent that auto‑discovers your agents and can schedule tasks. It’s the front door for everyone to use your agents and tools (supports your own domain and self‑hosting). |
| 46 | |
| 47 | 🧪 Workbench (app.xpander.ai) — Your control plane for any agent framework. Start with the Starter Kit template, then add tools from the menu: MCP servers, connectors, built‑in actions, or custom actions. |
| 48 | |
| 49 | 🏗️ AgentOS — Deploy agents of any framework on a production runtime in your VPC/Kubernetes or in xpander cloud; includes a reliable task scheduler and orchestration for long‑running jobs, plus stateful DB, logs, secrets, observability, and CI/CD. |
| 50 | |
| 51 | 🔌 Connector Hub — Generate and run MCP servers from OpenAPI specs or use the built‑in library of 2,000+ tools. Supports OAuth and API keys, and integrates natively with Claude, ChatGPT, and other MCP clients. |
| 52 | |
| 53 | 🛠️ AI Tools — OCR, browser automation, code interpreter, serverless code runner, PDF/CSV utilities, and more. |
| 54 | |
| 55 | ## 🚀 Getting Started |
| 56 | |
| 57 | Sign up and log in at https://app.xpander.ai |
| 58 | |
| 59 | Your account includes a preconfigured "Starter Kit" agent with a few tools and stateful storage to preserve sessions and showcase what’s possible. In Workbench, you can customize the system prompt, switch the model, or download the full agent code to modify and deploy. |
| 60 | |
| 61 | Workbench screenshot |
| 62 |  |
| 63 | |
| 64 | Then open Chat at https://chat.xpander.ai → pick the "Starter Kit" agent, add MCP tools, or ask it to run tasks. |
| 65 | |
| 66 | This unified Chat is a rich generalist agent that can schedule tasks across all your deployed agents. Anything you add in Workbench shows up here automatically. |
| 67 | |
| 68 | Example: |
| 69 |  |
| 70 | |
| 71 | ## 🛳️ Build More Agents & Ship to Production |
| 72 | |
| 73 | 🛠️ Managed Agents (serverless, ~2 min) |
| 74 | |
| 75 | - app.xpander.ai → New Agent → Starter Kit (or pick a framework) |
| 76 | - Add tools from the menu: MCP servers, connectors, built‑in actions, or custom actions |
| 77 | - Click Deploy → you get a stateful DB, logs, and CI/CD out of the box |
| 78 | |
| 79 | < |