EN
Memo Documentation
Welcome to the Memo documentation. Memo is a local-first, privacy-focused LLM chat application with a semantic RAG memory engine, agent tools, and multi-model orchestration. It runs entirely on your machine — no telemetry, no cloud dependency, no training on your data.
Current version: v3.1.2-beta
What is Memo?
Memo is your AI second brain. It runs LLMs locally via a bundled llama.cpp runtime, remembers everything you discuss in a SQLite + sqlite-vec vector store, and can use external cloud AI providers when you need more power. The choice is yours — per model, per conversation.
Core Capabilities
| Capability | Description |
|---|---|
| RAG Memory | Semantic vector search with hybrid retrieval (vector + FTS5) via Reciprocal Rank Fusion |
| Agent Mode | 12+ sandboxed tools — file operations, shell commands, web search, WhatsApp messaging |
| Orchestra Mode | Multi-model parallel workflows with a chief model coordinating 8 specialist roles |
| 7 Providers | OpenAI, Claude, Gemini, Grok, Groq, OpenRouter, Ollama — with smart fallback chains |
| WhatsApp Bridge | QR-pair with whatsmeow — read, search, reply, and AI-assisted messaging |
| Cloud Sync | E2E-encrypted Google Drive backup (AES-256-GCM, PBKDF2) |
| Mobile Companion | Thin Flutter app for Android/iOS — LAN, ngrok, or Tailscale tunneling |
| Proactive Learning | Intent extraction from conversations, automatic calendar events, mood engine |
Quick Links
Getting Started
- Quick Start Guide — Two terminals, up in 60 seconds
- Installation — One-click installers for every platform
- System Requirements — What your machine needs
- First Run Wizard — Setup walkthrough
- Build from Source — Compile from the repo
Core Concepts
- What is Memo? — Philosophy and full feature overview
- How RAG Memory Works — Embedding, retrieval, and persistence
- System Architecture — Two-process design and data flow
- Backend Architecture — Go backend deep dive
- Frontend Design — Flutter UI and state management
- Data Layer — SQLite, file layout, and persistence
Advanced Features
- Agent Mode — Tool-calling sandbox
- Orchestra Mode — Multi-model workflows
- External Providers — Cloud AI configuration
- Proactive Learning — Intent extraction and calendar
- Cloud Sync — Encrypted Google Drive backup
- WhatsApp Integration — Bridge setup and usage
- Mobile App — Remote companion
Development
- Development Guide — Architecture, conventions, tooling
- API Reference — REST + SSE endpoints
- CGO Flags — SQLite compilation requirements
- Build & Packaging — Releases and distribution
- Contributing — How to help
Reference
- Configuration — config.yaml reference
- Advanced Settings — All tuning knobs
- Technical Deep Dive — Internals explained
- UI Features — Interface tour
- Security — Encryption, permissions, and threat model
Resources
- Roadmap — What's coming next
- Troubleshooting — Common problems and solutions
- Release Notes — Version history
Memo is GNU AGPL v3 licensed. View on GitHub