latest release v0.1.12

Install MosAIc

My Own Secure AI Companion

MosAIc is an Open Platform Enabling Integration of Any Human Centric App Into The Internet Of AI

Looking for older builds? All releases on GitHub →

1 Download MosAIc

Choose the correct version for your system:

Installer (.exe) — x64 For 64-bit Windows (most common)

Edge browser users: Edge may flag the download as uncommon. Click the "···" (More actions) icon next to the file → "Keep" → then expand the "···" dropdown beside "Delete" and select "Keep anyway". Chrome and Firefox download without issues.

2 Install

Installer (.exe): Standard installation:

  • Double-click the downloaded .exe file
  • If Windows Defender SmartScreen appears, click "More info"
  • Then click "Run anyway"
  • The app will install and launch automatically

Windows may show a warning because the app is not code-signed. This is normal for open-source software.

3 Launch MosAIc

  • Find MosAIc Companion in your Start Menu
  • Or look for the desktop shortcut
  • The app will launch and you're ready to go!

1 Download MosAIc

Choose the correct version for your Mac's processor:

Apple Silicon (.dmg) For M-series Macs (arm64) Intel (.dmg) For Intel Macs (x64)

Not sure which version? Click the Apple menu → "About This Mac" → Look for "Chip" (Apple Silicon) or "Processor" (Intel).

2 Install the Application

DMG: Standard installation:

  • Open the downloaded .dmg file
  • Drag MosAIc Companion to your Applications folder
  • Eject the disk image when done

macOS will block the app the first time you open it, because it isn't code-signed by Apple yet. This is normal for open-source software and expected — step 3 is how everyone gets past it, and it takes a few seconds.

3 Let macOS know MosAIc is safe

Everyone installing on macOS does this step. If you skip it, macOS will tell you MosAIc Companion "is damaged and can't be opened" and offer to delete it. It isn't damaged — don't delete it. That message is simply what macOS says about any app it can't check with Apple.

Do this before you open MosAIc

Open Terminal (Applications → Utilities, or press ⌘ Space and type "Terminal"), paste this line, and press Enter:

xattr -cr /Applications/mosaic-companion.app

Then open MosAIc normally. This is the reliable route on every Mac — if you only do one thing on this page, do this.

You'll need this again after each update. The tag is applied to whatever you download, so a new version arrives with a new one. It's once per version installed, not once per launch — and it goes away entirely once MosAIc is code-signed.

What that command does: macOS attaches hidden labels to anything you download — including one marking it as "from the internet", which is what makes macOS refuse to open an app it can't check with Apple. The command clears those labels from MosAIc. It changes none of your security settings and affects no other app; it just tells macOS to stop treating this one file as a stranger.

Already saw the warning?

No harm done, as long as you didn't delete the app. Dismiss the message and run the command above — it works from that point just as well as before.

You may also see an Open Anyway button under System Settings → Privacy & Security, and on older macOS you can sometimes right-click the app and choose Open. Both are worth a try, but neither appears on every Mac — which is why the command above is the one we recommend.

Why this happens: apps distributed outside the App Store need a paid Apple developer certificate to avoid this warning, and we haven't set that up yet. It says nothing about whether the app is safe — only that Apple hasn't been paid to vouch for it. Once that's in place, this step disappears.

1 Download MosAIc

Choose the format that works best for your system:

Debian / Ubuntu (.deb) - Recommended:

deb — x64 For 64-bit Intel/AMD deb — ARM64 Temporarily unavailable — see below

AppImage (Universal, Portable):

AppImage — x64 For 64-bit Intel/AMD (x86_64) AppImage — ARM64 Temporarily unavailable — see below
ARM64 Linux builds are temporarily withdrawn.
The v0.1.12 ARM64 .deb and AppImage do not start: a native module they need was not built for ARM, so the app exits before a window appears. The fix is merged and will be in the next release. Mac and Windows downloads are unaffected, and so are the x64 Linux builds — this concerns Linux on ARM64 machines only, such as a Raspberry Pi or an ARM server. An Apple Silicon Mac is not affected. Details in issue #112.

2 Install

AppImage: Make it executable and run:

chmod +x ~/Downloads/mosaic-companion*.AppImage && ~/Downloads/mosaic-companion*.AppImage

Debian/Ubuntu (.deb): Install with dpkg (or double-click the file to open your package installer):

sudo dpkg -i ~/Downloads/mosaic-companion*.deb

On some newer distros, you might need FUSE for AppImage:

sudo apt install libfuse2

3 Run MosAIc

  • AppImage: Double-click the file or run from terminal
  • Deb: Find "MosAIc Companion" in your application menu