Welcome to MIRIX
MIRIX is a multi-agent personal assistant designed to track on-screen activities and answer user questions intelligently. By capturing real-time visual data and consolidating it into structured memories, MIRIX transforms your digital life into a visualizable memory.
-
Getting Started
Complete installation guide to get you up and running with MIRIX.
-
Architecture
Learn about the multi-agent system, memory components, and search capabilities that power MIRIX.
-
User Guide
Comprehensive guides for using the desktop app, backend, and managing your memories.
-
Advanced
Advanced topics including backup & restore, performance optimization, and security settings.
-
Contributing
Learn how to contribute to the MIRIX project and join our community.
How MIRIX Works
flowchart TD
A[Screen Capture] --> B[Meta Agent]
B --> C{Content Analysis}
C --> D[Core Memory<br/>Personal Info]
C --> E[Episodic Memory<br/>Activities]
C --> F[Semantic Memory<br/>Knowledge]
C --> G[Procedural Memory<br/>Workflows]
C --> H[Resource Memory<br/>Documents]
C --> I[Knowledge Vault<br/>Credentials]
J[User Query] --> K[Chat Agent]
K --> L[Memory Search]
D --> L
E --> L
F --> L
G --> L
H --> L
I --> L
L --> M[Intelligent Response]
Use Cases
Digital Activity Tracking
MIRIX automatically tracks your digital activities, from reading documents to browsing websites, creating a searchable timeline of your digital life.
Context-Aware Assistance
Ask questions about your recent activities: "What was I reading about machine learning yesterday?" or "Where did I save that document about PostgreSQL?"
Knowledge Management
Automatically extract and organize information from documents, websites, and applications you interact with.
Workflow Documentation
Learn and remember your common workflows, making it easier to repeat complex tasks.
System Requirements
- Python 3.11 or later
- Node.js 14 or later (for the desktop app)
- PostgreSQL 17 (recommended) or SQLite
- GEMINI API key (We use GEMINI because it can load images from google cloud and the API is free to end users.)
Ready to transform your digital experience with intelligent memory?
Key Capabilities
Intelligent Screen Tracking
- Takes screenshots every 1.5 seconds
- Processes visual data in real-time
- Automatically consolidates information
Multi-Agent Architecture
- 8 specialized agents working collaboratively
- 6 memory components for organized data storage
- Coordinated workflow for efficient processing
Advanced Search
- PostgreSQL-native BM25 search
- Vector similarity search using embeddings
- Field-specific search across all memory types
Privacy & Security
- All long-term data stored locally
- User-controlled privacy settings
- Secure screenshot handling with automatic cleanup
- Enterprise-grade PostgreSQL security