Skip to main content

Last updated: April 16, 2026

Install Naqi

After downloading

Naqi is a tiny desktop app (~10 MB). Install is a double-click on macOS, a click-through installer on Windows, and a package/AppImage on Linux. Pick your platform below.

macOS

Supported: macOS 12 Monterey or later. Universal binary covers both Apple Silicon (M1/M2/M3/M4) and Intel.

Install:

  • Download Naqi-x.y.z-macos-universal.dmg from the release page.
  • Double-click the DMG → drag Naqi into Applications.
  • Launch from Applications or Spotlight.

Using Homebrew?

brew install yasserstudio/naqi/naqi

About the Gatekeeper prompt: Naqi is signed with a Developer ID certificate and notarized by Apple, so you shouldn't see a "cannot verify developer" warning. If the first launch ever stalls (rare, sometimes happens on older macOS versions with strict quarantine), right-click the app in Applications and choose Open — that accepts the launch once and it won't prompt again.

Windows

Supported: Windows 10 (1809+) and Windows 11, 64-bit.

Heads-up — Windows SmartScreen will warn on first run. During the beta, the Windows build is not yet code-signed (signing costs ~$250/yr and we're deferring that until the beta graduates). This means Windows SmartScreen Defender shows an "unrecognized app" warning the first time you launch Naqi. The download itself is safe — the signature is missing, not the integrity. You can verify the SHA-256 checksum listed on the GitHub release page against the file you downloaded.

Install:

  • Download Naqi-x.y.z-windows-x64.msi from the release page.
  • Double-click the MSI. Windows SmartScreen will show a blue "Windows protected your PC" dialog.
  • Click More info (small link near the top of the dialog).
  • Click Run anyway — a button that appears after clicking More info.
  • The MSI installer runs. Accept the defaults or pick an install location, then Finish.
  • Launch Naqi from the Start menu.

Windows only prompts on the first run. After that, it remembers and launches directly. If you see the same prompt after an update, repeat the More info → Run anyway step.

Verify the download (optional):

Each release on GitHub includes SHA-256 checksums for every artifact. In PowerShell:

Get-FileHash .\Naqi-x.y.z-windows-x64.msi -Algorithm SHA256

Compare the output to the value next to the MSI on the release page. If they match, the file wasn't tampered with in transit.

Linux

Supported: Ubuntu 22.04+ (and derivatives), Fedora 38+, Debian 12+. Other distros work via AppImage.

Debian / Ubuntu (.deb):

sudo dpkg -i Naqi-x.y.z-linux-amd64.deb

If dpkg complains about missing dependencies:

sudo apt-get install -f

AppImage (any distro):

  • Download Naqi-x.y.z-linux-x86_64.AppImage.
  • Make it executable: chmod +x Naqi-x.y.z-linux-x86_64.AppImage
  • Run it: ./Naqi-x.y.z-linux-x86_64.AppImage

AppImage doesn't install — it just runs. To integrate with your desktop environment (menu entries, file associations), use AppImageLauncher.

First launch — what Naqi does

On the first launch, Naqi scans for installed AI clients (Claude Desktop, Cursor, VS Code, Windsurf, and 6 more) and builds a read-only inventory. It never writes to your config files without explicit confirmation.

  • No account required.
  • No internet connection required for scanning — everything runs locally.
  • First scan takes ~2 seconds on most workspaces.
  • You can enable Safe Mode (⌘⇧M on macOS, Ctrl+Shift+M elsewhere) to lock the workspace against accidental changes.

Troubleshooting

macOS: "App is damaged and can't be opened"

Very rare — means the quarantine attribute got mangled during download. Fix with:

xattr -cr /Applications/Naqi.app

Windows: SmartScreen dialog has no "More info" link

Check that you downloaded the MSI from github.com/yasserstudio/naqi/releases (the only official source). Some corporate endpoint-security tools replace the SmartScreen dialog with their own, which is stricter. In that case, ask your IT admin to whitelist Naqi or download it from a personal machine.

Linux: AppImage fails to launch

Most common cause is a missing FUSE library. Install:

sudo apt-get install libfuse2 (Debian/Ubuntu)
sudo dnf install fuse-libs (Fedora)

Still stuck?

Email support@getnaqi.com with your OS version and the exact error message. We respond within 1 business day.