Skip to content
YoMemo YoMemo

Official Desktop & Mobile Client

The YoMemo Official Client is a Flutter app for Windows, macOS, iOS, and Android. It uses the same hybrid encryption (RSA-OAEP + AES-GCM) as python-yomemo-mcp, so memories you save in the client are compatible with MCP and the REST API. The app includes a local password lock and idle timeout to protect access on your device.

Features

Section titled “Features”

Same encryption as MCP

Memories are encrypted client-side; the server never sees plaintext. You can use the client and MCP with the same API key and private key.

Local lock

Set a local password and optional idle timeout. Lock immediately with Ctrl+L (Windows/Linux) or ⌘+L (macOS).

Handle-based list

View and edit memories grouped by handle. Add, edit, and refresh from the home screen.

Free to use

Open source; download from GitHub Releases. No subscription required for the app itself (YoMemo storage limits still apply per your account).

Download

Section titled “Download”

Pre-built installers and archives are published on GitHub:

  • Releases — download the latest version for your platform.
PlatformFileNotes
Windowsyomemoai-client-windows.zipExtract the zip, then run yomemo_client.exe inside the extracted folder. Do not move the exe out of the folder (it needs the adjacent data/ and DLLs).
macOSyomemoai-client-macos.zipUnzip and open the .app. You may need to right-click → Open the first time if the app is not notarized.

Prerequisites

Section titled “Prerequisites”

Before using the app you need:

  • A YoMemo API key — get one at yomemo.ai (sign up / dashboard).
  • An RSA private key (PEM file) — same key you use with MCP or the Go SDK. If you don’t have one:
    Terminal window
    openssl genrsa -out private.pem 2048
    Keep private.pem secure and never share it.

First-time setup

Section titled “First-time setup”

  1. Install and open the app

    Download the right package from Releases, extract (Windows) or open the app (macOS). On first launch you may see a request to allow network or storage; allow as needed.

  2. Set a local password

    The app will ask you to set a local password. This protects access on this device only (it is not sent to the server). Choose a strong password and confirm it. You will use this to unlock the app after it locks (e.g. after idle timeout or manual lock).

  3. Configure API key and private key

    Open Settings (gear icon in the app bar). Enter your YoMemo API Key and choose your Private Key File (the path to your PEM file). Save. The app will load your existing memories and you can add or edit them.

Using the app

Section titled “Using the app”
  • Home screen — Lists memories grouped by handle. Use the refresh button to sync with the server. Use the + (FAB) to add a new memory (handle, content, optional description and idempotent key).
  • Edit / view — Tap a memory to view or edit it. Changes are encrypted and sent to YoMemo; they are compatible with MCP and the API.
  • Lock — Use the lock icon in the app bar or Ctrl+L / ⌘+L to lock immediately. After the idle timeout (configurable in Settings), the app locks automatically.
  • Settings — Change API key, private key file path, and lock timeout (minutes). You can also change your local password from Settings if you have already set one.
  • Help — The help menu (?) links to the documentation and the GitHub repo.

Shortcuts

Section titled “Shortcuts”
ShortcutAction
Ctrl+L (Windows/Linux) / ⌘+L (macOS)Lock the app immediately

Security

Section titled “Security”
  • Encryption — Same as MCP: client-side hybrid encryption (RSA-OAEP + AES-GCM). The server only stores ciphertext.
  • Local lock — Your local password and lock timeout protect access on the device only; they are not sent to YoMemo.
  • Private key — Stored only as a file path in app settings; the key is read from disk when needed. Prefer a key file that only the current user can read (e.g. permissions 600 on Unix).

For more, see Security and How it works.

Next steps

Section titled “Next steps”