Cineyma Documentation
A lightweight actor framework for Rust with typed messages, bounded mailboxes, OTP-style supervision, and distributed clustering.
What is Cineyma?
Cineyma is an actor framework for Rust inspired by Erlang/OTP and Akka. It provides a powerful model for building concurrent and distributed applications with:
- Type-safe messages — Compile-time guarantees for message passing
- Bounded mailboxes — Built-in backpressure to prevent OOM
- OTP-style supervision — Restart strategies and fault isolation
- Distributed clustering — Gossip protocol and remote actors
- Async/await native — Built on Tokio for excellent performance
Quick Example
Here's a simple counter actor that demonstrates Cineyma's core concepts:
Key Features
High Performance
Sub-microsecond message dispatch with linear scaling to thousands of actors
Panic Safety
Panics are caught at actor boundaries and never crash your runtime
Supervision Trees
OTP-style restart policies with configurable strategies
Distribution
Built-in clustering with gossip protocol and remote actors
Timers & Streams
Schedule delayed messages and integrate async streams
Type Safety
Compile-time message checking via generic handlers
Getting Started
Ready to build your first actor? Follow these steps:
Performance
Cineyma is designed for production workloads with excellent performance characteristics:
Community & Support
Cineyma is open source and community-driven. We'd love your feedback and contributions!