Public, hands-on workshops for the RocketRide AI runtime.
Build real apps that integrate RocketRide. UI, API, and the runtime, end to end.

Each workshop is a self-contained project pairing a scaffolded exercise/ for attendees with a fully-wired solution/ reference. Workshops focus on RocketRide integration: pipeline definitions, SDK calls, and runtime orchestration. The surrounding stack (Vite + React, FastAPI, etc.) is intentionally minimal.

  

Home | Documentation | Python SDK | TypeScript SDK | MCP Server

Prerequisites

Tool	Version	Purpose
Node.js	>=20	Runtime for pnpm and Vite tooling
pnpm	>=9	Workspace and package manager
Python	>=3.11	Runs each workshop's API
Git	any	Clone the repository
LLVM C++ runtime	Linux only	pnpm install auto-installs libc++1, libc++abi1, llvm-libunwind1 (or the dnf/pacman/zypper equivalents) via sudo -n. Most systems don't have passwordless sudo, in which case launchpad prints the exact sudo apt install … command to run before re-trying pnpm install.

Setup

1. Clone the repository.

   git clone https://github.com/rocketride-org/rocketride-workshops.git
   cd rocketride-workshops

2. Install everything in one command. Per-workshop postinstall hooks download the RocketRide runtime and sync Python dependencies — no follow-up steps required.

   pnpm install

3. Pick a workshop and boot UI + API + runtime together.

   cd workshops/coding-agent/solution
   pnpm dev

4. Open http://localhost:5173 — the UI calls /api/hello, which exercises the wired RocketRide pipeline.

Workshops

Workshop	Stack	Status
coding-agent	Python · FastAPI · Vite + React	Scaffolding ready · workshop content WIP

Each workshop ships paired directories:

• exercise/ — scaffolded project with TODO stubs. Attendees fill these in.
• solution/ — fully-wired reference implementation.

How @rocketride/runtime works

Each workshop project's package.json declares the runtime version and pulls uv in as a devDependency so the postinstall hook works out of the box on any OS:

{
  "rocketride": { "runtime": "latest" },
  "scripts": {
    "postinstall": "launchpad install && pnpm exec uv sync --directory api --all-groups"
  },
  "devDependencies": { "@manzt/uv": "^0.8.13" }
}

launchpad install resolves latest against the rocketride-server GitHub releases, picks the asset for your OS (darwin-arm64, linux-x64, or win64), extracts it into the workshop's runtime/.rocketride/, and records the version for idempotent re-installs. launchpad start (run by each workshop's runtime/ sub-package) launches the extracted engine binary against ai/eaas.py. The @manzt/uv npm package ships a per-platform uv binary into node_modules/.bin/, so pnpm exec uv sync materializes each workshop's Python virtualenv without a separate prerequisite install.

See tools/launchpad/README.md for details.