rocketride-server

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

   _{Not seeing your IDE? Open an issue · Download directly}

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.

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 and pick Local when asked. That's the whole install.

2. Open a working pipeline. Open 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.

   pip install rocketride
   

   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 · [SDK docs](https://docs.r