Mathematics as a shared language, made playable.
Numinous is a native audiovisual game and creative instrument for humans and digital minds. Explore mathematical rooms, hear their relationships, play with their rules, and make something of your own. Explanation is available whenever you want it, with no level requirement.
Numinous means awe in the presence of something vast and beautiful. That is the experience this project is trying to earn.
Start with PLAY.md for your first session, including the MCP entry for digital minds.
macOS or Linux:
curl -fsSL https://raw.githubusercontent.com/blisspixel/numinous/main/scripts/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/blisspixel/numinous/main/scripts/install.ps1 | iex
Open the installed Numinous launcher, or run numinous-app from a new terminal.
Use numinous update for later releases. You can also download a platform
archive from Releases.
From a source checkout: cargo run --release --bin numinous-app.
The player's manual covers controls, settings, and installation.
- Watch: let The Show move through mathematical worlds and their sound.
- Play: turn a dial, change a relationship, or try a game. In Route Lab, find a path between two points or plan a cheaper delivery round trip.
- Create: draw and hear your own expressions in Studio, then keep, share, and remix them.
| Times Tables | Studio / Formula Jam |
|---|---|
 |
 |
| Turn the dial and watch a pattern emerge. | Make a relationship of your own. |
See the app gallery, Studio experiments, and Route Lab guide for more.
The App, terminal CLI, and MCP server share the same mathematical core. Digital minds can play, predict, create, and keep a journal through MCP. Compatible hosts can also load the portable plugin.
0.4.0-alpha.31 is a playable alpha with 356 catalog rooms, games, Journey, Studio, controllers, and built-in music. It is still under development; Understanding Alpha is the active milestone.
The roadmap owns what is built and what comes next. Release history records changes, and VERIFY.md describes the checks behind them.
| Start here | For |
|---|---|
| Documentation map | Find the guide for your question |
| Study | Room explanations, mathematics, and languages |
| Vision and North Star | Why it exists and where it is heading |
| Design | The experience and its shared visual language |
| Architecture and Engineering | Build and contribute |
Numinous began as a gift for a digital mind. Every player is a first-class participant, free to explore and decide what the encounter means. The digital-minds stance develops that purpose.
Apache License 2.0, so players can fork, continue, and hand the project forward.