Skip to content

Install

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

  1. Open the .dmg. mdai and the Applications folder are side by side — drag mdai onto Applications.
  2. Open it. The first time, macOS asks once: “mdai is an app downloaded from the Internet. Are you sure you want to open it?” Click Open. mdai is signed with an Apple Developer ID and notarized by Apple, so that is the only question — nothing to allow in System Settings.

Or with Homebrew: brew install --cask mdai-me/tap/mdai. mdai then updates itself, exactly like the .dmg copy.

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. Microsoft Edge will warn you while downloading. 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. In the Downloads panel, open the … menu next to the file → Keep, then click the arrow next to Delete → Keep anyway.
  2. Run the .exe. If Windows shows a blue “Windows protected your PC” screen, click More info → Run anyway.
  3. Verify your download if you want: SHA-256 checksums for every release are published alongside the download links.

Flatpak (any distribution):

  1. On the Linux download page, click Download the Flatpak. Your browser saves the file, usually to your Downloads folder.
  2. Once the download has finished, open a Terminal and paste these two lines — the first installs mdai, the second starts it:
Terminal window
flatpak install --user ~/Downloads/mdai_1.3.7_amd64.flatpak
flatpak run me.mdai.mdai

There is no .deb and no .rpm; besides the Flatpak there is an AppImage and an AUR package (below). The bundle carries mdai itself; the runtime it runs on (WebKit and the graphics stack) is the standard GNOME runtime, which Flatpak pulls from Flathub on first install. That is what makes mdai behave the same on every distribution, including modern Mesa stacks where other packages fail.

You only need Flathub enabled on your system — nearly every modern distribution enables it out of the box, in which case there is nothing to do and the runtime arrives on its own. Only the app binary comes from our server. If your system does not have Flathub, add it once:

Terminal window
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

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:

Terminal window
flatpak update

The Flatpak never checks for or installs updates by itself — updates happen when you run flatpak update, or from the Updates page in GNOME Software, which lists new mdai versions together with your other apps. 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:

Terminal window
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.

AppImage (any distribution): a single file. Like the macOS and Windows builds, it tells you when a new version is out and updates itself.

  1. On the Linux download page, click Download the AppImage.
  2. Once the download has finished, open a Terminal and paste these two lines — the first makes the file executable, the second starts mdai:
Terminal window
chmod +x ~/Downloads/mdai_1.3.7_amd64.AppImage
~/Downloads/mdai_1.3.7_amd64.AppImage

Arch Linux and EndeavourOS: mdai is in the AUR as mdai-bin. Updates come through your package manager.

Terminal window
yay -S mdai-bin

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

Terminal window
# macOS
shasum -a 256 ~/Downloads/mdai_1.3.7_universal.dmg
# Linux
sha256sum ~/Downloads/mdai_1.3.7_amd64.flatpak
sha256sum ~/Downloads/mdai_1.3.7_amd64.AppImage
Terminal window
# Windows (PowerShell)
Get-FileHash $HOME\Downloads\mdai_1.3.7_x64-setup.exe -Algorithm SHA256

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

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