# Irisu ML: reconstructing Irisu Syndrome! normal mode

> Irisu ML reconstructs Irisu Syndrome! v2.03 normal mode as a deterministic C++20 simulator, Python learning environment and playable browser client. It models input timing, seeded spawning, scoring, chains and progression, with original-format replay support. The author reports event-level matches on four eligible instrumented playbacks and a selected-seed high-score replay.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/Gabriel-Kahen/irisu-ml>
- Primary source: <https://github.com/Gabriel-Kahen/irisu-ml/blob/835f0b4930531d7e5697b58e2da6fbfcc57cf59d/README.md>
- Catalog page: <https://awesomerea.org/resources/irisu-ml-case/>
- Record JSON: <https://awesomerea.org/resources/irisu-ml-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/irisu-ml-case/index.md)

## Requirements & limits

- **Prerequisites:** A C++20 build is required for the native simulator; the Python interface needs the separately built native library.
- **Prerequisites:** The optional exact MSVC physics host requires separately generated local dependencies.
- **Scope:** The published high-score replay covers a selected seed.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/Gabriel-Kahen/irisu-ml/blob/835f0b4930531d7e5697b58e2da6fbfcc57cf59d/README.md>
2. <https://github.com/Gabriel-Kahen/irisu-ml/blob/835f0b4930531d7e5697b58e2da6fbfcc57cf59d/pyproject.toml>

## More in Games

- [IW4L: a Rust runtime that plays Modern Warfare 2 from the user’s installed game](https://awesomerea.org/resources/iw4l-mw2-rust-runtime-case/index.md) · Case study
- [Jade Cocoon on Bevy: a Rust engine reimplementation](https://awesomerea.org/resources/jade-cocoon-on-bevy-case/index.md) · Case study
- [Jazz² Resurrection: a native C++ reimplementation of Jazz Jackrabbit 2](https://awesomerea.org/resources/jazz2-resurrection-engine-case/index.md) · Case study
- [JGR Portable: a native PSP reconstruction of Jet Grind Radio](https://awesomerea.org/resources/jgr-portable-case/index.md) · Case study
- [jpog-decomp: rebuilding Jurassic Park: Operation Genesis and Toshi](https://awesomerea.org/resources/jpog-decomp-case/index.md) · Case study
- [JSettlers: a Java remake of The Settlers III](https://awesomerea.org/resources/jsettlers-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.