MIRASIM WIKI
Home/Windows
Windows
Mirasim on Windows
Short answer: there is no official Windows build. Mirasim publishes macOS arm64 packages, an Android APK and a VS Code extension — nothing for Windows. This page lays out what that means and what your options actually are.
What Mirasim publishes
Taken from the official download page for v0.0.149, refreshed automatically.
The official release for v0.0.149 contains a macOS arm64 DMG, a macOS arm64 CLI archive, an Android APK, a VS Code extension and a checksum file. There is no .exe, no .msi and no Windows archive. Anything advertised as an official "Mirasim for Windows" installer is not from Mirasim.
| Platform | Official status | Notes |
|---|---|---|
| macOS (Apple Silicon) | Supported | DMG and CLI, macOS 13+, arm64 only |
| Android | Supported | APK, sideload it yourself |
| VS Code | Extension published | VSIX; behaviour without the desktop app is not documented |
| iOS | TestFlight only | Public invites not open |
| Windows | No official build | Community port exists; see below |
| Intel Mac · Linux | No official build | No announced plans |
The community Windows updater
A real open-source project — but read what it is before you download it.
A developer going by Adularia-Z publishes mirasim-win-updater, an MIT-licensed tool that keeps an existing Windows copy of Mirasim up to date. It works because Mirasim is an Electron shell plus a platform-neutral JavaScript payload: the tool pulls the official payload or extracts the new shell out of the official DMG, then rewrites only the files that changed. It verifies the SHA-256 of everything it downloads and checks the payload's ed25519 signature against the public key taken from the shell.
Open source, MIT, auditableThe whole tool is one readable JavaScript file, and you can build the exe yourself in two commands instead of trusting a binary.
Verifies what it downloadsSHA-256 on the DMG and the payload, plus ed25519 signature verification on the payload — the same check the app itself does.
Backs up and rolls backChanged and deleted files are backed up first, and --rollback restores the previous version completely.
It is an updater, not an installerIts own docs are explicit: it cannot produce a Windows install from scratch, because the Electron runtime and Windows native modules have to come from an install you already have. If you have never had Mirasim on Windows, this tool gives you nothing to run.
The exe is unsignedInjecting the SEA payload invalidates Node's signature, so the build ships unsigned and SmartScreen will warn on first run.
Not affiliated with MirasimThe author states plainly that it is a personal tool with no connection to Mirasim. Nobody at Mirasim reviews, signs or supports it.
⚠ Before you download anything called "Mirasim for Windows"
An unofficial build of a developer tool runs with your permissions, your files and your API keys in reach. Treat every such file as untrusted until you have checked it yourself.
- The only files Mirasim itself publishes come from
cdn-assets.mirasim.ai. Anything else — however convincing the page looks — is somebody else's build. - Prefer reading the source and building it yourself over running a prebuilt, unsigned exe. This project documents how, and it needs no preinstalled toolchain.
- If you do run a third-party binary, do it on a machine that holds no credentials you care about, and never paste API keys into it.
- You carry the risk. This wiki links the project because it is open and honest about its limits — that is not a security review, and not an endorsement.
Source and releases: https://github.com/Adularia-Z/mirasim-win-updater · latest release. Read the README and the porting notes first — they are candid about what the tool cannot do.
What a Windows user can actually do today
Ordered by how little can go wrong.
A cloud or remote Mac
Mirasim needs Apple Silicon and macOS 13+. A rented Mac mini instance, or an M-series Mac you can reach remotely, runs the official build with no modifications at all.
Watch for an official build
This wiki re-reads the official download page every 30 minutes. The moment a Windows package appears in the official release, the download table here shows it — no need to check by hand.
Read the community port, then decide
If you already run Mirasim on Windows, the updater above is the maintained way to move between versions. Read the source, build it yourself, keep the backups it makes.
The Android app, on a phone
The APK is official and works on a normal Android phone, which is a real way to use Mirasim without a Mac — just not on your Windows desktop.
This is this wiki's invite code. Mirasim is invite-only — without a code there is no way in. Use it to activate your account for free; you then get a code of your own, and inviting others earns you a paid month.
FAQ
Is there an official Mirasim Windows version?
No. As of v0.0.149 the official release contains macOS arm64 builds, an Android APK and a VS Code extension. No exe, no msi, no Windows archive.
Is the community Windows updater safe?
It is open source under MIT, it verifies SHA-256 and an ed25519 signature on what it downloads, and it can roll back — which is more care than most unofficial tools take. It is also unsigned, unaffiliated with Mirasim and unreviewed by them. Read the source or build it yourself, and run it on a machine where a mistake would not cost you credentials.
Can that updater install Mirasim on Windows for me?
No, and its own documentation says so: it can only update a Windows install that already exists, because the Electron runtime and Windows native modules must be taken from that install. From zero it produces nothing runnable.
Will Mirasim support Windows later?
Nothing has been announced. The app is in Alpha and macOS-first. This page and the download table update automatically, so if that changes you will see it here.