Your AI-powered memory companion that remembers what you do, so you don't have to.

🇨🇳 中文文档

Nemori is a local-first desktop application that acts as your personal memory assistant. It quietly observes your screen activity, builds a searchable memory of your digital life, and helps you recall anything through natural conversation.

Think of it as having a friendly companion who:

• 📸 Watches your screen and takes notes automatically
• 🧠 Remembers what you've been working on
• 💬 Chats with you about your memories
• 🔒 Keeps everything private on your local machine

A cute floating companion that lives on your desktop, showing recording status. Right-click for quick access to all features.

Have natural conversations with an AI that actually knows what you've been doing. Two modes available:

• Chat Mode: Quick Q&A about your memories - "What was I working on yesterday?"
• Agent Mode: Deep analysis with step-by-step reasoning for complex questions

Review your daily activities through an intelligent journal that automatically captures and organizes your screen activity.

Browse and search through your episodic memories, semantic knowledge, and personal profile. Memories are automatically categorized into 8 life dimensions: Career, Finance, Health, Family, Social, Growth, Leisure, and Spirit.

Discover patterns in your behavior with AI-generated insights about your work habits, interests, and preferences.

• All data stored locally on your machine
• No cloud sync, no tracking
• You control your memories

Download the latest release for your platform from GitHub Releases.

1. Open the DMG and drag Nemori to Applications
2. If you see "Nemori is damaged", run in Terminal:

   xattr -cr /Applications/Nemori.app

1. Open Nemori and go to Settings
2. Enter your LLM API credentials (supports OpenAI-compatible APIs)
3. Grant screen recording permission when prompted
4. Click Start Recording to begin

• 🐾 Summon the pet from the sidebar to keep Nemori on your desktop
• 💬 Chat to ask questions about your activities
• 📖 Browse journal to review your day
• 💡 Check insights to discover patterns

Nemori requires an LLM API for chat and embedding. We recommend OpenRouter for easy access to multiple models.

Your data is stored locally:

• macOS/Linux: ~/.local/share/Nemori/
• Windows: %APPDATA%/Nemori/

• Node.js 18+
• Python 3.12+

# Clone the repository
git clone https://github.com/nemori-ai/nemori-desktop.git
cd nemori-desktop

# Install backend dependencies
cd backend
pip install -e .

# Install frontend dependencies
cd ../frontend
npm install

# Start development
npm run dev

npm run build:mac

┌─────────────────────────────────────────┐
│         Electron Frontend               │
│  (React + TypeScript + Tailwind CSS)    │
├─────────────────────────────────────────┤
│           Electron Main Process         │
│   (Window management, Desktop Pet)      │
└─────────────────┬───────────────────────┘
                  │ HTTP/REST
                  ▼
┌─────────────────────────────────────────┐
│          Python Backend                 │
│    (FastAPI + SQLite + ChromaDB)        │
├─────────────────────────────────────────┤
│  • LLM Service (OpenAI compatible)      │
│  • Memory Service (Episodic/Semantic)   │
│  • Screenshot Capture & Analysis        │
│  • Vector Search (ChromaDB)             │
└─────────────────────────────────────────┘

Apache License 2.0 - see LICENSE for details.

Contributions are welcome! Please feel free to submit a Pull Request.

Built with ❤️ by nemori-ai

This project was inspired by and references techniques from:

• MIRIX - AI-powered personal memory assistant
• MineContext - Context-aware screen understanding