Rocketride Server

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

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

Where to start

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

Features

Quick Start

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

   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.

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.

   bashCopy code
   pip install rocketride
   

   pythonCopy code
   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

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 is the standard "ask questions about my documents" pattern. Needs one LLM key and a vector database (Qdrant 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 shows the shape.

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.

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:

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 to be installed.

     bashCopy code
     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. Same portable pipeline JSON, zero infrastructure to run, from prototype to production. Get started

6. Run your pipelines as standalone processes or integrate them into your existing Python and TypeScript/JS 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.

Documentation

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

Repo-wide contributor rules live in 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; 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/. A new provider, tool, or store makes a good first contribution. Guide: 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.
• 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 · Releases: RELEASE.md · Security reports: SECURITY.md · Questions: Discussions, Discord, SUPPORT.md

Two ways to run RocketRide

Let us handle the infrastructure, or own every layer.

RocketRide Cloud  NOW LIVE

Run pipelines, not infrastructure.

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

bashCopy code
ROCKETRIDE_URI=https://api.rocketride.ai
ROCKETRIDE_AUTH=your-api-token

On-Prem  FREE & MIT

Own every layer.

Point a client at your local engine in one line:

bashCopy code
ROCKETRIDE_URI=ws://localhost:5565

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 to get started.