Skip to content

jamsocket/plane

Folders and files

NameName
Last commit message
Last commit date

Latest commit

87daf25 · Feb 10, 2025
Jun 25, 2024
Jul 11, 2024
Feb 10, 2025
Mar 20, 2024
Dec 10, 2024
Aug 29, 2024
Feb 10, 2025
Feb 10, 2025
Dec 14, 2023
Jan 5, 2024
Dec 14, 2023
Feb 10, 2025
Dec 3, 2024
Oct 7, 2024
Oct 1, 2024

Repository files navigation

Docker image Build Docker Image Tests Chat on Discord crates.io

Plane is a distributed system for running stateful WebSocket backends at scale. Plane is heavily inspired by Figma’s mulitplayer infrastructure, which dynamically spawns a process for each active document.

Use cases include:

  • Scaling up authoritative multiplayer backends.
  • Running isolated code environments (like REPLs, code notebooks, and LLM agent sandboxes).
  • Data-intensive applications that need a dedicated high-RAM process for each active user session.

How Plane works

You can think of Plane as a distributed hashmap, but instead of storing data, it stores running processes. When you ask Plane for the process associated with a key (via an HTTP API), it either returns a URL to an existing process, or starts a new process and returns a URL to that.

Plane will keep the process running for as long as there is an open connection (usually a WebSocket connection) to it. Once all connections to a process have been closed for some time threshold, Plane will shut down the process.

Plane guarantees that only one process will be running for each key at any given time, allowing that process to act as an authoritative source of document state for as long as it is running.

Architecture

Read more about Plane’s architecture.

Architecture diagram of Plane

Learn more

About

A distributed system for running WebSocket services at scale.

Topics

Resources

License

Stars

Watchers

Forks

Languages