Documentation

Getting Started

Documentation Home

Quick Start

Installation

System Requirements

First Run Wizard

Build from Source

Self-Hosting

Core Concepts

What is Memo?

How RAG Memory Works

Architecture Overview

Backend Architecture (Go)

Frontend Design (Flutter)

Data Layer & Persistence

Design Philosophy

Features

Features Catalog

Chat & Conversation

RAG Semantic Memory

Model Management

Llama.cpp Integration

Vector Search Logic

Incognito Mode

Multimodal (Vision & Voice)

Performance

Advanced Features

Agent Mode

Orchestra Mode

External Providers

Proactive Learning & Calendar

Cloud Sync

WhatsApp Integration

Telegram Integration

Mobile Companion App

Backup & Restore

Developer API Gateway

Development

Developer Guide

API Reference

CLI Reference

CGO Build Flags

Build & Packaging

Contributing

Default System Prompt

Reference

Configuration Reference

Advanced Settings

Technical Deep Dive

UI Features

Security

Resources

Troubleshooting

Known Issues

Resolved Issues

FAQ

Release Notes

Roadmap

Installation Guide

Memo ships with one-click installers for every desktop platform, an APK for Android, and — new as of v3.5.5 — dedicated installers for running it headless on a server. The desktop app bundles llama.cpp — no Docker, no terminal, no manual setup required to get a working chat + local model. Self-hosting on a Pi/home server/VPS is where Docker and the terminal become genuinely useful options, not requirements for everyone.

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

One-Line Install

Every install method below is a single command — no manual download, no unzip-and-drag. Each script auto-detects your OS/architecture, downloads the right archive, and either installs fresh or updates an existing install in place (config, memory, models, and providers are always preserved on an update).

What you want	Platform	Command
Desktop app (stable)	Linux / macOS	`curl -fsSL https://download.bugradev.com/get-memo.sh \| bash`
Desktop app (stable)	Windows	`irm https://download.bugradev.com/get-memo.ps1 \| iex`
Desktop app (beta — every push to `main`)	Linux / macOS	`curl -fsSL https://download.bugradev.com/get-memo-beta.sh \| bash`
Desktop app (beta)	Windows	`irm https://download.bugradev.com/get-memo-beta.ps1 \| iex`
Desktop app	Linux arm64 (Raspberry Pi, ARM NAS)	`curl -fsSL https://download.bugradev.com/get_memo_arm.sh \| bash`
Self-hosted, server-only (no desktop app)	Linux x86_64/arm64, macOS	`curl -fsSL https://download.bugradev.com/get-memo-server.sh \| bash`
Self-hosted, server-only (beta)	Linux x86_64/arm64, macOS	`curl -fsSL https://download.bugradev.com/get-memo-server-beta.sh \| bash`

Run in PowerShell (not cmd.exe) on Windows — irm is Invoke-RestMethod, iex is Invoke-Expression, together the PowerShell equivalent of curl | bash. See Self-Hosting for the full server/Docker/CasaOS walkthrough, auth setup, and CLI management — this page covers the desktop path.

Platform Installers (Manual Download)

Prefer downloading a file yourself instead of piping a script into your shell? Every archive above is also available directly:

Platform	Format	Instructions
Windows	`.exe`	`Memo-Setup-v3.5.5.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
Linux arm64	`.zip`	Same layout as the x86_64 tarball, for Raspberry Pi / ARM boards
macOS	`.zip`	Universal build (Apple Silicon + Intel)
Android	`.apk`	Sideload — pairs with desktop over LAN or tunnel

Windows Installation

Download Memo-Setup-v3.5.5.exe from the download portal, or run irm https://download.bugradev.com/get-memo.ps1 | iex in PowerShell
Double-click the installer (or let the script launch it for you)
Follow the installation wizard
Launch Memo from the Start Menu or desktop shortcut
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

One-line installer (Recommended)

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

Installs to ~/.memo, adds a memo command to your PATH, and creates an app-menu entry. Re-running the same command later updates in place.

AppImage (Manual)

chmod +x Memo-linux-x64-v3.5.5.AppImage
./Memo-linux-x64-v3.5.5.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.5.5.tar.gz
cd Memo
./memo-backend    # runs the backend
./memo_flutter    # launches the Flutter UI

Raspberry Pi / Linux arm64

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

Same install/update logic as the x86_64 installer, just targeting arm64. Prefer a headless setup on a Pi instead? See Self-Hosting — get-memo-server.sh auto-detects arm64 too and skips the desktop UI entirely.

macOS Installation

One-line install:

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

Manual:

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

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

Android Installation

Download Memo-Android-v3.5.5.apk
Enable "Install from unknown sources" in Android Settings
Install the APK
Open the app and enter your desktop's IP address or scan the LAN
Optionally configure an ngrok auth token, or connect straight to a self-hosted backend, for remote access

The Android app is a thin companion client — it streams from your desktop or self-hosted backend. The AI model, memory, and your data never leave that machine.

Self-Hosted / Server-Only Install

New as of v3.5.5. For running Memo unattended on a Raspberry Pi, home server, or VPS with no display — the backend, CLI, and engine binaries only, no desktop UI:

curl -fsSL https://download.bugradev.com/get-memo-server.sh | bash        # stable
curl -fsSL https://download.bugradev.com/get-memo-server-beta.sh | bash   # beta

Or as a Docker container (multi-arch, amd64 + arm64) — ideal for CasaOS, Unraid, Synology, or any Docker host:

docker pull ghcr.io/bugraakdemir/memo-backend:latest

Both set up a real 4-mode authentication system (none/token/password/token+password) and a full memo config/remote/service/provider/agent/model CLI toolkit for managing everything over SSH. See the Self-Hosting guide for the complete walkthrough, and the CLI Reference for exact command syntax.

What's Included

The installer bundles everything:

✅ Go backend binary
✅ Flutter desktop UI (skipped by the server-only installer and the Docker image)
✅ llama.cpp (llama-server) for local model inference
✅ vec0 for vector similarity search
✅ whisper.cpp for speech-to-text (not bundled in the Docker image, to keep it small)
✅ SQLite with sqlite-vec extension
✅ Default configuration (config.yaml)
✅ Empty data directory structure

After Installation

Launch Memo and the first-run wizard will:

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

Updating

Every one-line installer above is also the updater — re-run the exact command you used to install, and it refreshes binaries/engine while preserving config, memory, models, sessions, providers, and skills:

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

A dedicated updater that doesn't require remembering which install script you originally used also works, for desktop installs:

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

Uninstallation

Windows / macOS (manual installs): Windows → Add/Remove Programs → Uninstall Memo. macOS → drag Memo.app to Trash.

One-line uninstallers (Linux/macOS, offer a memory backup first):

curl -fsSL https://download.bugradev.com/uninstall.sh | bash          # desktop install
curl -fsSL https://download.bugradev.com/uninstall-arm.sh | bash      # Linux arm64 — cleans up a native install, a Docker/CasaOS one, or both
curl -fsSL https://download.bugradev.com/uninstall-selfhosted.sh | bash  # server-only install (get-memo-server.sh) — also stops/removes the systemd service

Each removes ~/.memo/, the memo CLI wrapper, any desktop entry/icon, and (uninstall.sh/uninstall-arm.sh) the Flutter app's own saved preferences (language, theme, setup-wizard state) so a reinstall genuinely starts fresh. None of them delete anything without asking first, and each offers to back up your memory/sessions data before removing it.

You can also export your data as a .memo archive before uninstalling — Settings → Backup → Export Archive — in addition to (not instead of) the uninstaller's own backup prompt.