Repository files navigation

Build and scale stateful workloads

Rivet is an open-source library for long-lived processes.
Like Lambda — but with realtime, persistence, and hibernation.
Easilyself-hostable and workswith your infrastructure.

Quickstart •Documentation •Changelog •Discord •X

Projects that live in this repository:

• RivetKit: Library for building with Rivet
  • TypeScript: Client & server
  • Rust, Client only, experimental
  • Python: Client only, experimental
  • OpenAPI: OpenAPI spec for RivetKit
• Rivet Engine: High-performance, Rust-based engine that powers Rivet at scale
  • Pegboard: Actor orchestrator & networking
  • Gasoline: Durable execution engine that powers Rivet
  • Guard: Proxy for routing traffic to Rivet Actors
  • Epoxy: Multi-region KV store based on Epaxos
• Rivet Dashboard: Like Chrome Inspector, but for Rivet
• Rivet Documentation: Documentation atrivet.dev/docs
• Rivet Website: Source code forrivet.dev

Rivet provides everything you need to build fast, scalable, and real-time applications without the complexity.

• Long-Lived, Stateful Compute: Persistent memory between requests
• No Database Round Trips: State stored locally for speed
• Realtime, Made Simple: WebSocket/SSE updates built-in
• Sleep When Idle: Hibernation with zero cold starts
• Insane Scale: Auto-scale from zero to millions
• Resilient by Design: Built-in failover and recovery
• Edge State Storage: Geographically distributed state
• Web Standards: WebSockets, SSE, HTTP compatible
• No Vendor Lock-In: Open-source, self-hostable

• AI Agent
• Realtime Docs
• Workflows
• Local-First Sync
• Per-User Database
• Background Jobs
• Rate Limiting
• Multiplayer Game
• Bots

Get started with Rivet by following a quickstart guide:

• Node.js & Bun Quickstart - Set up Rivet with Node.js, Bun, and web frameworks
• React Quickstart - Set up Rivet with React
• Next.js Quickstart - Set up Rivet with Next.js
• Cloudflare Workers Quickstart - Set up Rivet with Cloudflare Workers

The fastest way to deploy Rivet is to useRivet Cloud withyour cloud of choice. Rivet Cloud provides multiple edge regions & cloud providers for you.

You do not need Rivet Engine to get started with Rivet.

View more options & deployment guides in theself-hosting documentation.

# Dockerdocker run -p 6420:6420 rivetkit/engine# macOS (Apple Silicon)curl -o rivet-engine"https://releases.rivet.gg/engine/latest/rivet-engine-aarch64-apple-darwin"&& chmod +x rivet-engine&& ./rivet-engine start# macOS (Intel)curl -o rivet-engine"https://releases.rivet.gg/engine/latest/rivet-engine-x86_64-apple-darwin"&& chmod +x rivet-engine&& ./rivet-engine start# Linux (x86)curl -o rivet-engine"https://releases.rivet.gg/engine/latest/rivet-engine-x86_64-unknown-linux-musl"&& chmod +x rivet-engine&& ./rivet-engine start# Windows (x86_64)curl.exe -o rivet-engine.exe"https://releases.rivet.gg/engine/latest/rivet-engine-x86_64-pc-windows-gnu.exe".\rivet-engine.exe start

Deploy Rivet Actors anywhere - from serverless platforms to your own infrastructure with Rivet's flexible runtime options.

• Rivet Cloud(1-Click Deploy)
• Postgres
• File System
• Memory

• Node.js
• Bun
• Deno
• Vercel(1-Click Deploy)
• Railway(1-Click Deploy)
• Durable Objects
• Kubernetes
• AWS ECS
• Google Cloud Run
• Hetzner
• VM & Bare Metal
• AWS Lambda(On The Roadmap)
• Supabase(On The Roadmap)
• Freestyle(On The Roadmap)

Seamlessly integrate Rivet with your favorite frameworks, languages, and tools. Don't see what you need?Request an integration.

• JavaScript
• TypeScript
• React
• Rust
• Next.js
• Svelte
• Vue(Help Wanted)

• Hono
• Express
• Elysia
• tRPC

• Better Auth

• Vitest

• AI SDK(On The Roadmap)

• LiveStore(On The Roadmap)
• ZeroSync(Help Wanted)
• TinyBase(Help Wanted)
• Yjs(Help Wanted)

Debug and monitor your Rivet applications with powerful built-in tools:

• Live State Inspection: View and edit your actor state in real-time
• Event Monitoring: Track all events and messages in your system
• REPL: Debug your actors interactively
• Connection Inspection: Monitor active connections and their state

Join thousands of developers building with Rivet Actors today:

• Discord - Chat with the community
• X/Twitter - Follow for updates
• Bluesky - Follow for updates
• GitHub Discussions - Ask questions and share ideas
• GitHub Issues - Report bugs and request features
• Talk to an engineer - Discuss your technical needs, current stack, and how Rivet can help with your infrastructure challenges

Apache 2.0