<div align="center">

<a href="https://rocketride.org">
  <img src="docs/public/assets/poster.png" alt="RocketRide: Open Source AI Pipeline Tool" width="100%">
</a>

<p>
  <strong>RocketRide is the open source AIDE: the AI Development Environment.</strong><br/>
  Build, deploy and harness production-ready AI solutions at light speed, all within your IDE or using the CLI in your terminal.
</p>

<p>
<img src="docs/public/assets/icon-cpp.png" alt="C++" />&nbsp;&nbsp;
<img src="docs/public/assets/icon-python.png" alt="Python" />&nbsp;&nbsp;
<img src="docs/public/assets/icon-typescript.png" alt="TypeScript" />
</p>

<p>
 Your code editor just became the AIDE. RocketRide turns the classic IDE you already use into a full <strong>AI Development Environment</strong>: one place to compose, debug, observe, and deploy AI runtimes using any model, any tool, any framework, with zero vendor lock-in. Equipped with deep observability and backed by a battle-tested, high-throughput C++ engine, what you build is production-ready the moment it runs. <strong>It's the harness for everything behind your AI applications, not just the agents, but the whole stack beneath them.</strong>
</p>

<p>
 Under the hood, RocketRide is an open source data pipeline builder and runtime built for AI and ML workloads. With 100+ pipeline nodes spanning 15+ LLM providers, 9 vector databases, OCR, NER, and more, pipelines are defined as portable JSON, built visually in VS Code, and executed by a multithreaded C++ runtime. From real-time data processing to multimodal AI search, RocketRide runs entirely on your own infrastructure.
</p>

<p>
  <a href="https://rocketride.org">Home</a> |
  <a href="https://docs.rocketride.org/">Documentation</a> |
  <a href="https://pypi.org/project/rocketride/">Python SDK</a> |
  <a href="https://www.npmjs.com/package/rocketride">TypeScript SDK</a> |
  <a href="https://docs.rocketride.org/connect/mcp/http">MCP Server</a> |
  <a href="https://marketplace.visualstudio.com/items?itemName=RocketRide.rocketride">VS Code Marketplace</a> |
  <a href="https://open-vsx.org/extension/RocketRide/rocketride">Open VSX Registry</a>
</p>

<p>
  <a href="https://github.com/rocketride-org/rocketride-server/actions/workflows/ci.yml"><img src="https://github.com/rocketride-org/rocketride-server/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="https://github.com/rocketride-org/rocketride-server/releases"><img src="https://img.shields.io/github/v/release/rocketride-org/rocketride-server?filter=server-v*&label=Runtime&color=5f2167&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxOTEgMTkxIj48cGF0aCBkPSJNMTU5LjUgMTYxLjRMMTUzLjcgMTY3LjJDMTUxLjkgMTY5IDE0OC45IDE2OSAxNDcgMTY3LjJMMTI2LjYgMTQ2LjhDMTE1LjYgMTM1LjggMTE1LjYgMTE4IDEyNi42IDEwN0MxMzguMSA5NS41IDEzOC4xIDc2LjkgMTI2LjYgNjUuNEwxMjUuMSA2My45QzExMy42IDUyLjQgOTUgNTIuNCA4My41IDYzLjlDNzIuNSA3NC45IDU0LjYgNzQuOSA0My42IDYzLjlMMjMuMiA0My41QzIxLjQgNDEuNyAyMS40IDM4LjcgMjMuMiAzNi44TDI5IDMxQzM3IDIzIDQ5LjEgMjAuNSA1OS42IDI0LjlMODcuNSAzNi4zQzk3LjMgNDAuMSAxMDguNCAzOCAxMTYuMyAzMS4xTDEzNyAxMC40QzEzOC42IDguOSAxNDAuNCA3LjQgMTQyLjUgNi4yQzE0Ni4yIDQuMSAxNTAuMyAzIDE1NC41IDIuNkwxODUuNCAwQzE4OC4zLS4zIDE5MC44IDIuMiAxOTAuNSA1LjFMMTg3LjggMzYuNEMxODcuMyA0Mi44IDE4NC41IDQ4LjggMTgwLjEgNTMuNUwxNjAuNSA3My4xQzE1Mi41IDgxLjIgMTUwLjEgOTMuMyAxNTQuNSAxMDMuOEwxNTUuNSAxMDYuMkwxNjEuMiAxMjBMMTY1LjYgMTMwLjlDMTY5LjkgMTQxLjQgMTY3LjUgMTUzLjUgMTU5LjUgMTYxLjVaIiBmaWxsPSJ3aGl0ZSIvPjxwYXRoIGQ9Ik0uOCAxOTAuM0MtLjIgMTg5LjMtLjMgMTg3LjYuNiAxODYuNEwyMS4xIDE2MkMzMS4xIDE1MCAzNy45IDEzNy43IDQxLjMgMTI1LjNDNDMuNiAxMTYuNiA0NC42IDEwOC41IDQ0LjEgMTAxLjJDNDQuMSAxMDAuMyA0NC40IDk5LjQgNDUuMSA5OC44QzQ1LjggOTguMiA0Ni44IDk3LjkgNDcuNyA5OC4xQzY1IDEwMS42IDgzLjUgOTguMyA5OC41IDg4LjlDOTkuNiA4OC4yIDEwMS4xIDg4LjQgMTAyIDg5LjNDMTAyLjkgOTAuMiAxMDMuMSA5MS43IDEwMi40IDkyLjhDOTMgMTA3LjggODkuNyAxMjYuMyA5My4yIDE0My41QzkzLjQgMTQ0LjMgOTMuMiAxNDUuMiA5Mi42IDE0NS45QzkyIDE0Ni42IDkxIDE0Ny4yIDkwLjEgMTQ3LjFDODIuOCAxNDYuNiA3NC42IDE0Ny41IDY2IDE0OS45QzUzLjYgMTUzLjIgNDEuMiAxNjAgMjkuMyAxNzAuMUw0LjkgMTkwLjZDMy44IDE5MS41IDIuMSAxOTEuNSAxIDE5MC40SC44WiIgZmlsbD0iI0Y5MzgyMiIvPjwvc3ZnPgo=" alt="Runtime version"></a>
  <a href="https://discord.gg/PMXrtenMsY"><img src="https://img.shields.io/badge/Discord-Join-370b7a?logo=discord&logoColor=white" alt="Discord"></a>
  <a href="https://github.com/rocketride-org/rocketride-server/blob/develop/LICENSE"><img src="https://img.shields.io/badge/License-MIT-41b6e6" alt="MIT License"></a>
</p>

<img src="docs/public/assets/pipeline-example.png" alt="Build and run AI pipelines inside your IDE" width="100%">

_Design, test, and ship complex AI workflows from a visual canvas, right where you write code._

<img src="docs/public/assets/sdk-example.png" alt="Integrate real AI solutions using a simple SDK" width="100%">

_Drop pipelines into any Python or TypeScript app with a few lines of code, no infrastructure glue required._

</div>

## Where to start

<table>
<tr>
<td width="50%" valign="top" align="left"><strong>Run it locally</strong><br/><br/>Install the extension, pick <strong>Local</strong>, and run a pipeline on your own machine. Nothing to sign up for.<br/><br/><a href="#quick-start"><strong>Quick Start →</strong></a></td>
<td width="50%" valign="top" align="left"><strong>Shipping your first AI feature?</strong><br/><br/>Start from what you already know: a working pipeline in three steps, no API keys.<br/><br/><a href="#your-first-ai-feature"><strong>Start here →</strong></a></td>
</tr>
<tr>
<td valign="top" align="left"><strong>Want to contribute?</strong><br/><br/>Claim an issue with one comment, add a node in Python, or fix the docs you're reading.<br/><br/><a href="#contributing"><strong>Contributing →</strong></a></td>
<td valign="top" align="left"><strong>Want to run it without ops?</strong><br/><br/>We operate the engine; your <code>.pipe</code> runs unchanged, with nothing to provision.<br/><br/><a href="#rocketride-cloud-now-live"><strong>RocketRide Cloud →</strong></a></td>
</tr>
</table>

**Open source, MIT.** The whole engine is MIT-licensed and OSI-compliant. No enterprise edition, nothing behind a paywall.

## Features

| Feature                           | Description                                                                                                                                                                                                                          |
| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Visual Pipeline Builder**       | Drag, connect, and configure nodes in VS Code, no boilerplate. Real-time observability tracks token usage, LLM calls, latency, and execution. Pipelines are portable JSON, version-controllable, shareable, and runnable anywhere. |
| **High-Performance C++ Runtime**  | Native multithreading purpose-built for the throughput demands of AI and data workloads. No bottlenecks, no compromises for production scale.                                                                                        |
| **100+ Pipeline Nodes**           | 15+ LLM providers, 9 vector databases, OCR, NER, PII anonymization, chunking strategies, embedding models, and more. All nodes are Python-extensible, build and publish your own.                                                    |
| **Multi-Agent Workflows**         | Built-in CrewAI and LangChain support. Chain agents, share memory across pipeline runs, and manage multi-step reasoning at scale.                                                                                                    |
| **Coding Agent Ready**            | RocketRide auto-detects your coding agent: Claude, Cursor, and more. Build, modify, and deploy pipelines through natural language.                                                                                                  |
| **TypeScript, Python & MCP SDKs** | Integrate pipelines into native apps, expose them as callable tools for AI assistants, or build programmatic workflows into your existing codebase.                                                                                  |
| **Zero Dependency Headaches**     | Python environments, C++ toolchains, Java/Tika, and all node dependencies managed automatically. Clone, build, run, no manual setup.                                                                                                |
| **One-Click Deploy**              | Run on Docker, on-prem, or [RocketRide Cloud](https://cloud.rocketride.ai/). Production-ready architecture from day one, not retrofitted from a demo.                                                                               |

## Quick Start

1. Install the extension for your IDE. Search for RocketRide in the extension marketplace:

   <p align="center">
     <img src="docs/public/assets/install-extension.png" alt="Install RocketRide extension">
   </p>

   <sub>[Not seeing your IDE? Open an issue](https://github.com/rocketride-org/rocketride-server/issues/new) · [Download directly](https://open-vsx.org/extension/RocketRide/rocketride)</sub>

2. Click the RocketRide extension in your IDE

3. Deploy a server - you'll be prompted on how you want to run the server. Choose the option that fits your setup:

   - **Local (Recommended)** - This pulls the server directly into your IDE without any additional setup.
   - **On-Premises** - Run the server on your own hardware for full control and data residency. Pull the image and deploy to Docker or clone this repo and [build from source](CONTRIBUTING.md#getting-started).

## Your first AI feature

_Whether you build web apps, integrate APIs, or run backend services, you already have the mental model._

| You already know | Same idea in RocketRide |
| :-- | :-- |
| A route that receives a request | A **source node**: `webhook`, `chat`, or `dropper` (file drop) |
| Middleware chained in order | **Nodes**, wired together on a canvas. Most are Python you can open and read |
| The response you return | A **response** node |
| Config in git, like a Dockerfile | The `.pipe` file: plain JSON, diffable, reviewable |
| Calling a service from your app | The Python or TypeScript SDK: one call in, one result out |

**Three steps, no API keys:**

1. **Run it locally.** Follow the [Quick Start](#quick-start) and pick **Local** when asked. That's the whole install.

2. **Open a working pipeline.** Open [`examples/document-processor.pipe`](examples/document-processor.pipe) in your IDE. Give it a PDF or an image and it pulls out the text (including text inside images), finds names, addresses and other personal data, and returns a cleaned copy. It runs on local models, so nothing leaves your machine. Press ▶ on the source node to start it. Its source is a `webhook`, so it waits for input — step 3 is how you send some.

3. **Call it from your code.** The pipeline is now a function your service can call. Run it from the folder you opened in your IDE: the extension writes the engine's connection details into a `.env` there, and the SDK reads them automatically. Run it from anywhere else and the client falls back to RocketRide Cloud instead.

   ```bash
   pip install rocketride
   ```

   ```python
   import asyncio
   from rocketride import RocketRideClient


   async def main():
       async with RocketRideClient() as client:
           run = await client.use(filepath='examples/document-processor.pipe')
           out = await client.send(
               run['token'], 'Alice Smith, 12 Elm St, Springfield.', objinfo={'name': 'note.txt'}, mimetype='text/plain'
           )
           print(out)
           await client.terminate(run['token'])


   asyncio.run(main())
   ```

   TypeScript works the same way: [`npm install rocketride`](https://www.npmjs.com/package/rocketride) · [SDK docs](https://docs.rocketride.org/clients/typescript)

**Next steps, one at a time:**

- **Add a model.** Drop an `llm_*` node between the source and the response and add one API key. Same pipeline, now with an LLM in the loop.
- **Search by meaning.** [`examples/rag-pipeline.pipe`](examples/rag-pipeline.pipe) is the standard "ask questions about my documents" pattern. Needs one LLM key and a vector database ([Qdrant](https://qdrant.tech/) can run locally).
- **Give it tools.** An **agent** node is an LLM allowed to call other nodes in a loop until it's done. [`examples/agent-workflow.pipe`](examples/agent-workflow.pipe) shows the shape.

<details>
<summary><strong>Words you'll see, translated</strong></summary>

| Term | What it means here |
| :-- | :-- |
| **Pipeline** | A request handler built from steps, saved as a `.pipe` JSON file |
| **Node** | One step. Providers (OpenAI, Anthropic…), tools (GitHub, Slack…), stores, parsers |
| **Embedding** | Turning text into a list of numbers so "similar meaning" becomes "nearby numbers" |
| **Vector database** | A store that finds records by meaning instead of exact match |
| **RAG** | Retrieve the relevant documents first, then ask the model with them in context |
| **Agent** | An LLM that can call tools and nodes repeatedly until the task is done |
| **OCR / NER / PII** | Read text out of images / find names, dates, organisations / detect personal data |
| **Chunking** | Splitting long documents into pieces small enough to embed and retrieve |

</details>

## Building Your First Pipe

1. All pipelines are recognized with the `*.pipe` format. Each pipeline and its configuration are JSON objects - but the extension in your IDE will render within our visual builder canvas.

2. All pipelines begin with a source node: _webhook_, _chat_, or _dropper_. For specific usage, examples, and inspiration on how to build pipelines, check out our [guides and documentation](https://docs.rocketride.org/).

3. Connect input lanes and output lanes by type to properly wire your pipeline. Some nodes like agents or LLMs can be invoked as tools for use by a parent node as shown below:

   <p align="center">
     <img src="docs/public/assets/first_pipe.gif" alt="Pipeline canvas example" width="100%">
   </p>

4. You can run a pipeline from the canvas by pressing the ▶ button on the source node or from the `Connection Manager` directly.

5. Deploy your pipelines - pick the path that fits:

   - **Docker** - Download the RocketRide server image and create a container. Requires [Docker](https://docs.docker.com/get-docker/) to be installed.

     ```bash
     docker pull ghcr.io/rocketride-org/rocketride-engine:latest
     docker create --name rocketride-engine -p 5565:5565 ghcr.io/rocketride-org/rocketride-engine:latest
     ```

   - **Local Deployment** - Download your preferred runtime as a standalone process from the **Deploy** page in the `Connection Manager`.

   - **RocketRide Cloud** - Skip the setup and ship straight to [managed hosting](https://cloud.rocketride.ai/). Same portable pipeline JSON, zero infrastructure to run, from prototype to production. [Get started](https://cloud.rocketride.ai/)

6. Run your pipelines as standalone processes or integrate them into your existing [Python](https://docs.rocketride.org/clients/python) and [TypeScript/JS](https://docs.rocketride.org/clients/typescript) applications utilizing our SDK.

## Observability

Selecting running pipelines allows for in-depth analytics. Trace call trees, token usage, memory consumption, and more to optimize your pipelines before scaling and deploying. Find the models, agents, and tools best fit for your task.

<p align="center">
  <img src="docs/public/assets/tracing.gif" alt="Pipeline observability and tracing">
</p>

## Documentation

Everything on [docs.rocketride.org](https://docs.rocketride.org/) is built from the [`docs/`](docs/) tree in this repo, split by audience. [`docs/README.md`](docs/README.md) is the full map; the short version:

| Looking for | Start at |
|---|---|
| Using RocketRide: quickstart, concepts, guides, cloud, self-hosting | [`docs/public/product/`](docs/public/product/) (the site, page for page) |
| SDK guides | [TypeScript](docs/public/typescript/) · [Python](docs/public/python/) · [MCP](docs/public/mcp/) |
| Building your own client on the engine protocol | [`docs/public/product/connect/websocket/`](docs/public/product/connect/websocket/) |
| Contributing: setup, builder, engine internals, node authoring | [`docs/development/`](docs/development/index.md) |
| Node catalog | each node's `README.md` under [`nodes/src/nodes/`](nodes/src/nodes) |
| Apps: VS Code extension and the shell UIs | each app's own folder under [`apps/`](apps/); how they fit the monorepo in [`docs/development/apps/`](docs/development/apps/index.md) |
| Pointing an AI assistant at RocketRide | [`docs/agents/`](docs/agents/README.md) |

Repo-wide contributor rules live in [AGENTS.md](AGENTS.md).

## Contributing

**Good places to start**

- **Claim an issue with one comment.** Comment `/assign` on any open issue and it's yours. No permissions or membership needed.
- **Good first issues** are labelled [`good first issue`](https://github.com/rocketride-org/rocketride-server/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22); `help wanted` marks bigger ones we'd like a hand with.
- **Add a node.** Every node is a small Python package under [`nodes/src/nodes/`](nodes/src/nodes). A new provider, tool, or store makes a good first contribution. Guide: [Adding a New Node](docs/development/nodes/index.md#adding-a-new-node).
- **Fix what you just read.** Docs PRs are welcome, including this README.

**How it works**

- Fork, branch as `<type>/RR-<issue>-<short-description>`, open a PR against `develop`, link the issue. Full process, style guides, and test commands: [CONTRIBUTING.md](CONTRIBUTING.md).
- One build tool for the whole monorepo: `./builder` manages the C++ toolchain, Python environments, and Java/Tika for you. Clone, build, run.
- Roles and decisions: [GOVERNANCE.md](GOVERNANCE.md) · Releases: [RELEASE.md](RELEASE.md) · Security reports: [SECURITY.md](SECURITY.md) · Questions: [Discussions](https://github.com/rocketride-org/rocketride-server/discussions), [Discord](https://discord.gg/PMXrtenMsY), [SUPPORT.md](.github/SUPPORT.md)

<div align="center">

## Two ways to run RocketRide

_Let us handle the infrastructure, or own every layer._

<br/>

<table>
<tr>
<td width="50%" valign="top" align="left"><strong>ROCKETRIDE CLOUD</strong> &nbsp;·&nbsp; <code>NOW LIVE</code></td>
<td width="50%" valign="top" align="left"><strong>ON-PREM</strong></td>
</tr>
<tr>
<td valign="top" align="left"><strong>Let us run it, zero ops</strong><br/><br/>The fastest way to get started. We operate the engine; you point a client at the endpoint and build. The same <code>.pipe</code> file runs unchanged, with no infrastructure to provision, from prototype to production.</td>
<td valign="top" align="left"><strong>Run it yourself, free</strong><br/><br/>Docker, on-prem, or local. Full control and data residency. Open source, MIT, no lock-in, ever.</td>
</tr>
<tr>
<td align="center"><a href="https://cloud.rocketride.ai/"><strong>Get Started</strong></a></td>
<td align="center"><a href="#quick-start"><strong>Quick Start</strong></a></td>
</tr>
</table>

</div>

## RocketRide Cloud &nbsp;<code>NOW LIVE</code>

<div align="center">

### Run pipelines, not infrastructure.

<p>
<strong>With RocketRide Cloud, offload the complex, heavy lifting of production AI.</strong><br/>
Build your pipeline once, in the same portable <code>.pipe</code> format, and we run it, scale it, and keep it fast. No servers, no ops, no rewrite from prototype to production.
</p>

</div>

<table>
<tr>
<td width="50%" valign="top" align="left"><strong>A fraction of the cost</strong><br/><br/>Our model server runs your AI workloads far more efficiently, so you pay a fraction of what standard hosting costs.</td>
<td width="50%" valign="top" align="left"><strong>Collaborate as a team</strong><br/><br/>Work together on shared pipelines. Your whole team builds, runs, and iterates in one place.</td>
</tr>
<tr>
<td valign="top" align="left"><strong>No-hassle infra</strong><br/><br/>We handle everything: servers, scaling, upgrades, uptime. Nothing to provision, nothing to operate.</td>
<td valign="top" align="left"><strong>Higher performance, built-in scale</strong><br/><br/>More throughput on the multithreaded C++ engine, with automatic scalability built in.</td>
</tr>
</table>

<br/>

Connecting takes two lines. Same portable pipeline JSON, now hosted for you:

```bash
ROCKETRIDE_URI=https://api.rocketride.ai
ROCKETRIDE_AUTH=your-api-token
```

<p align="center">
  <a href="https://cloud.rocketride.ai/"><strong>Get Started</strong></a> &nbsp;&nbsp;·&nbsp;&nbsp; <a href="https://docs.rocketride.org/operate/cloud">Read the Cloud docs</a>
</p>

## On-Prem &nbsp;<code>FREE &amp; MIT</code>

<div align="center">

### Own every layer.

<p>
<strong>Run the very same engine yourself, wherever your data lives.</strong><br/>
Docker, on-premises, or a local process in your IDE. Full control, full data residency, and zero lock-in. The exact <code>.pipe</code> you build on Cloud runs unchanged on your own hardware.
</p>

</div>

<table>
<tr>
<td width="50%" valign="top" align="left"><strong>Full control and data residency</strong><br/><br/>Your data and model calls never leave your infrastructure. Run it behind your firewall, or fully air-gapped.</td>
<td width="50%" valign="top" align="left"><strong>Open source, MIT</strong><br/><br/>The whole engine is MIT-licensed and OSI-compliant. No enterprise edition, nothing behind a paywall.</td>
</tr>
<tr>
<td valign="top" align="left"><strong>Runs anywhere</strong><br/><br/>Docker, on-premises, bare metal, or local. Scale out to a cluster with the Helm chart when you need to.</td>
<td valign="top" align="left"><strong>The same C++ engine</strong><br/><br/>Identical multithreaded runtime and execution semantics as Cloud. Move a pipeline between them anytime.</td>
</tr>
</table>

<br/>

Point a client at your local engine in one line:

```bash
ROCKETRIDE_URI=ws://localhost:5565
```

<p align="center">
  <a href="#quick-start"><strong>Quick Start</strong></a> &nbsp;&nbsp;·&nbsp;&nbsp; <a href="https://docs.rocketride.org/operate/self-hosting">Read the On-Prem docs</a>
</p>

<p align="center">Ready to ship? Deploy your pipeline on <a href="https://cloud.rocketride.ai/">RocketRide Cloud</a>, or run on-prem, free.</p>

## Contributors

RocketRide is built by a growing community of contributors. Whether you've fixed a bug, added a node, improved docs, or helped someone on Discord, thank you. New contributions are always welcome - check out our [contributing guide](CONTRIBUTING.md) to get started.

<a href="https://github.com/rocketride-org/rocketride-server/graphs/contributors">
  <img alt="contributors" src="https://contrib.rocks/image?repo=rocketride-org/rocketride-server&columns=16" width="100%" />
</a>

---

<p align="center">Made with ♥ in SF &amp; EU</p>