Welcome to Risansym

Risansym is a modern, strict, and performant discrete event simulator built for designing and analyzing distributed systems algorithms.

It offers a robust Python core powered by Pydantic and a beautiful, high-performance web visualizer built with React and Next.js.

---

Why Risansym?

• Strict & Type-Safe: Built with Python's modern typing system and validated using Pydantic.
• Decoupled Architecture: The core simulation engine is completely independent of the visualizer. It generates rich JSON traces that can be analyzed anywhere.
• Visual Feedback: Load your traces into the web visualizer to watch your algorithm unfold event by event.
• Educational & Professional: Whether you're learning about logical clocks (e.g. Chandy-Lamport) or prototyping a complex network protocol, Risansym provides the perfect environment.

Next Steps

• Jump into the Getting Started guide to install the library.
• Learn how to build your first protocol in the Writing Algorithms tutorial.
• Explore the API Reference for detailed documentation on the framework's classes.