Installation Guide

Memo ships with one-click installers for every desktop platform and an APK for Android. llama.cpp is bundled — no Docker, no terminal, no manual setup.

All downloads are available at memo.bugradev.com and the GitHub Releases page.

Quick Install (macOS & Linux)

Skip the manual download — one command detects your OS, downloads the right archive, and installs everything:

curl -fsSL https://download.bugradev.com/get-memo.sh | bash

Safe to re-run: your config and data are preserved, only the binaries are refreshed. This is the fastest path if you're comfortable with a terminal; otherwise use the platform installers below.

Platform Installers

Platform	Format	Instructions
Windows	.exe	Memo-Setup-v3.1.0.exe — double-click, follow the wizard
Linux	.AppImage	chmod +x and run — universal on any distro
Linux	.deb	sudo dpkg -i memo-*.deb on Debian/Ubuntu
Linux	.tar.gz	Extract and run the portable binary
macOS	.zip	Universal build (Apple Silicon + Intel)
Android	.apk	Sideload — pairs with desktop over LAN or tunnel

Windows Installation

1. Download Memo-Setup-v3.1.0.exe from the download portal
2. Double-click the installer
3. Follow the installation wizard
4. Launch Memo from the Start Menu or desktop shortcut
5. The first-run wizard guides you through initial setup

Windows SmartScreen may show a warning. This is expected for new software. Click "More info" → "Run anyway".

Linux Installation

AppImage (Recommended)

chmod +x Memo-linux-x64-v3.1.2-beta.AppImage
./Memo-linux-x64-v3.1.2-beta.AppImage

Works on Debian, Ubuntu, Fedora, Arch, and any glibc-based distribution.

Debian Package

sudo dpkg -i memo_*.deb
sudo apt-get install -f  # if dependencies are missing

Portable Archive

tar -xzf Memo-linux-x64-v3.1.2-beta.tar.gz
cd memo
./memo        # runs the backend
./memo_app    # launches the Flutter UI (if bundled separately)

macOS Installation

1. Download Memo-macos.zip
2. Extract the archive
3. Drag Memo.app to Applications
4. On first launch, right-click → Open to bypass Gatekeeper
5. Follow the setup wizard

macOS Gatekeeper may block the unsigned app. Go to System Settings → Privacy & Security and click "Open Anyway".

Android Installation

1. Download Memo-Android-v3.1.2-beta.apk
2. Enable "Install from unknown sources" in Android Settings
3. Install the APK
4. Open the app and enter your desktop's IP address or scan the LAN
5. Optionally configure an ngrok auth token for remote access

The Android app is a thin companion client — it streams from your desktop. The AI model, memory, and your data never leave your computer.

What's Included

The installer bundles everything:

• ✅ Go backend binary
• ✅ Flutter desktop UI
• ✅ llama.cpp (llama-server) for local model inference
• ✅ vec0 for vector similarity search
• ✅ whisper.cpp for speech-to-text
• ✅ SQLite with sqlite-vec extension
• ✅ Default configuration (config.yaml)
• ✅ Empty data directory structure

After Installation

Launch Memo and the first-run wizard will:

1. Ask for your name and the assistant's name
2. Let you choose a personality preset
3. Check and download llama.cpp if needed
4. Discover available models for download

Uninstallation

• Windows: Add/Remove Programs → Uninstall Memo
• Linux (AppImage): Delete the .AppImage file and ~/.local/share/memo/
• Linux (.deb): sudo dpkg -r memo
• macOS: Drag Memo.app to Trash and delete ~/Library/Application Support/memo/
• Android: Uninstall from app settings

Your data directory (~/memo-data/ or equivalent) is not deleted during uninstall. Remove it manually if you want a clean slate.

Export your data as a .memo archive before uninstalling — Settings → Backup → Export Archive.