Skip to main content

Local Development Stack

Run a full Rodiun stack locally without any external credentials using rodiun dev.

Prerequisites

  • Python ≥ 3.9 with rodiun installed (pip install rodiun)
  • Go ≥ 1.21 (for the Operon runtime binary)

Start the local stack

rodiun dev

This starts the Go Operon runtime on http://localhost:8080 in dev mode with all provider calls simulated.

Available mock Orbs

Orb IDProviderNotes
rodiun.notification-email@1.0.0Resend (mock)Always returns success
rodiun.database-query@1.0.0PostgreSQL (mock)Returns sample rows
rodiun.auth-token@1.0.0Auth0 (mock)Returns a test JWT
rodiun.file-upload@1.0.0S3 (mock)Returns a fake presigned URL
rodiun.payment-intent@1.0.0Stripe (mock)Returns a test payment intent

Run an Orb against the local stack

rodiun run rodiun.notification-email@1.0.0 \
--inputs '{"to":"test@example.com","from_address":"dev@local","subject":"Test","body":"Hello dev"}' \
--endpoint http://localhost:8080

Fetch a receipt

curl http://localhost:8080/receipts/<run_id>

Reset dev state

rodiun dev --reset