ActorCore is a framework for building stateful, scalable, realtime backend applications. Whether you’re building multiplayer games, collaborative apps, AI agent backends, or any stateful service, ActorCore provides the tools and patterns to simplify your architecture.

​
Core Concepts

In ActorCore, each actor has these key characteristics:

  • State Is Automatically Persisted: State automatically persists between restarts, upgrades, & crashes
  • State Is Stored In-Memory: State is stored in memory for high-performance reads/writes while also automatically persisted
  • Isolated State Ownership: Actors only manage their own state, which can only be modified by the actor itself
  • Communicates via Actions: How clients and other actors interact with an actor
  • Actions Are Low-Latency: Actions provide WebSocket-like performance for time-sensitive operations
  • Broadcast Updates With Events: Actors can publish real-time updates to connected clients

​
Get Started

Integrate ActorCore with your project:

React

Seamlessly connect React applications to your ActorCore backend with ready-to-use hooks and components.

Node.js & Bun

Connect to ActorCore from any JavaScript application with the official client library.

Rust

High-performance Rust client for systems programming and game development.

​
Deploy

Choose your platform to deploy ActorCore:

Rivet

Deploy ActorCore applications on Rivet’s purpose-built cloud platform with built-in scaling and management.

Cloudflare Workers

Run ActorCore at the edge with Cloudflare Workers for global low-latency applications.

Bun

Use ActorCore with the fast Bun JavaScript runtime for performance-focused development.

Node.js

Run ActorCore in traditional Node.js environments for maximum compatibility.

​
Concepts

Learn the core concepts that power ActorCore applications:

Overview

Introduction to ActorCore concepts and architecture.

Interacting with Actors

Learn how to connect to and interact with actors from clients.

State

Understand how actor state is managed, persisted, and accessed.

Actions

Define and implement actor actions (RPCs) for client interaction.

Events

Real-time communication with events and broadcasts.

Lifecycle

Managing the creation, execution, and termination of actors.

Schedule

Schedule tasks and alarms with actors for time-based operations.

Authentication

Implement secure authentication for your ActorCore applications.

​
More Concepts

Connections

Manage client connections and sessions with actors.

Metadata

Working with actor metadata for discovery and organization.

Testing

Comprehensive testing strategies for ActorCore applications.

Logging

Implement logging for debugging and monitoring.

CORS

Configure Cross-Origin Resource Sharing for web clients.

Scaling

Strategies for scaling ActorCore applications horizontally.

External SQL

Integrate with external SQL databases for additional persistence.

Types

Type system and validation in ActorCore for robust applications.

Topology

Understanding actor topology models for distributed systems.

​
Reference

Integrate ActorCore with Large Language Models:

Cursor

Use Cursor AI coding assistant with ActorCore.

Windsurf

Windsurf AI integration with ActorCore.

Claude Code

Claude AI integration with ActorCore.

Docs as Markdown

Use ActorCore docs as markdown with LLMs for better assistance.

prompts.txt

Prompting best practices for ActorCore with LLMs.

llms.txt

General LLM integration guide for ActorCore.

llms-full.txt Full

Comprehensive LLM integration guide for advanced use cases.

​
Support

GitHub Issues

Report bugs and request features on GitHub.

GitHub Discussions

Join the community discussions for help and ideas.

Changelog

Stay up-to-date with the latest ActorCore releases.

Discord

Join the Rivet Discord server to chat with the community.

Enterprise

Learn about enterprise support options for ActorCore.