Install

Download mdai for your platform from the home page. Every install starts a full-featured 15-day trial — no account, no email required.

macOS

1. Open the .dmg and drag mdai into Applications.
2. Open it. That’s all — mdai is signed with an Apple Developer ID and notarized by Apple, so there is no security warning and nothing to click through.

Windows

Get mdai from the Microsoft Store — recommended.

The Store copy is signed by Microsoft, so it installs without any warning, and Windows keeps it up to date for you. It is the same application — the licence works identically whichever copy you install.

Or the direct installer:

1. Run the .exe.
2. You will see a Windows SmartScreen warning. The direct installer is not code-signed yet (certificates for small independent apps are disproportionately expensive; the Store copy is signed by Microsoft instead). The app is exactly what you downloaded from this site. Click More info → Run anyway.
3. Verify your download if you want: SHA-256 checksums for every release are published alongside the download links.

Linux

Flatpak (any distribution):

flatpak install --user mdai_1.2.0_amd64.flatpak
flatpak run me.mdai.mdai

The Flatpak is the only Linux package for v1 — there is no .deb, no .rpm, and no AppImage. It bundles its own runtime (WebKit + Mesa), so it runs the same on every distribution, including modern Mesa stacks where other packages fail. The runtime is pulled automatically from Flathub on first install.

Immutable / atomic distros (Fedora Silverblue, openSUSE MicroOS, and similar): Flatpak is the native package format there — it needs no root and touches nothing in your system package manager.

Updates. The download above is wired to our signed release repository, so new versions arrive the usual way:

flatpak update

Nothing is installed in the background and nothing phones home on its own — updates happen when you ask for them. If you installed the bundle above, that repository is already registered for you — there is nothing to add. If you would rather add it yourself first and install from there:

flatpak remote-add --user --from mdai https://dl.mdai.me/mdai.flatpakrepo
flatpak install --user mdai me.mdai.mdai

Every release in that repository is signed with our GPG key (8812 F630 C573 F675 B1A3 E7CD A199 6BB0 B576 7E1D), and Flatpak refuses anything that does not match it.

Verify your download (optional)

SHA-256 checksums for every file are published at dl.mdai.me/SHA256SUMS.txt. To check a download, compare its hash against that file:

# macOS
shasum -a 256 mdai_1.2.0_universal.dmg

# Linux
sha256sum mdai_1.2.0_amd64.flatpak

# Windows (PowerShell)
Get-FileHash mdai_1.2.0_x64-setup.exe -Algorithm SHA256

The printed hash must match the line for that filename in SHA256SUMS.txt.

After installing

Open mdai and follow the welcome screen: pick a folder for your notes and (optionally) connect an AI key. See Your first vault.