Install
Download mdai for your platform from the download page. Every install starts a full-featured 15-day trial — no account, no email required.
- Open the
.dmg. mdai and the Applications folder are side by side — drag mdai onto Applications. - 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.
Windows
Section titled “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:
- 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.
- Run the
.exe. If Windows shows a blue “Windows protected your PC” screen, click More info → Run anyway. - Verify your download if you want: SHA-256 checksums for every release are published alongside the download links.
Flatpak (any distribution):
- On the Linux download page, click Download the Flatpak. Your browser saves the file, usually to your Downloads folder.
- Once the download has finished, open a Terminal and paste these two lines — the first installs mdai, the second starts it:
flatpak install --user ~/Downloads/mdai_1.3.7_amd64.flatpakflatpak run me.mdai.mdaiThere 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:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepoImmutable / 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 updateThe 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:
flatpak remote-add --user --from mdai https://dl.mdai.me/mdai.flatpakrepoflatpak install --user mdai me.mdai.mdaiEvery 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.
- On the Linux download page, click Download the AppImage.
- Once the download has finished, open a Terminal and paste these two lines — the first makes the file executable, the second starts mdai:
chmod +x ~/Downloads/mdai_1.3.7_amd64.AppImage~/Downloads/mdai_1.3.7_amd64.AppImageArch Linux and EndeavourOS: mdai is in the AUR as mdai-bin. Updates come
through your package manager.
yay -S mdai-binVerify your download (optional)
Section titled “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:
# macOSshasum -a 256 ~/Downloads/mdai_1.3.7_universal.dmg
# Linuxsha256sum ~/Downloads/mdai_1.3.7_amd64.flatpaksha256sum ~/Downloads/mdai_1.3.7_amd64.AppImage# Windows (PowerShell)Get-FileHash $HOME\Downloads\mdai_1.3.7_x64-setup.exe -Algorithm SHA256The printed hash must match the line for that filename in SHA256SUMS.txt.
After installing
Section titled “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.