Mnemo AI
A local agentic AI assistant with MCP (Model Context Protocol) integration, RAG capabilities, and intelligent conversation management. Built on LangGraph with LangChain for multi-provider LLM support (Ollama, Amazon Bedrock, Bedrock Mantle, OpenAI, Anthropic, Amazon SageMaker AI, LiteLLM).
📖 Documentation
Full documentation is available at https://brunopistone.github.io/mnemoai/
- Getting Started
- Usage & commands
- Configuration
- Orchestration & sub-agents
- Memory & learning
- Everyday tools
- Architecture
- Development
🚀 Quick Start
pip install mnemoai-assistant # or: uv tool install mnemoai-assistant
mnemoai # verbose (shows thinking); --no-verbose to hide
On first run, if no config is found, an interactive configurator launches and walks you through picking a provider, model, and feature toggles — then writes ~/.mnemoai/config/config.yaml.
→ See the Getting Started guide for full setup.
✨ Key Features
- 🤖 Multi-Model Support: Ollama (local), Amazon Bedrock, Bedrock Mantle, OpenAI, Anthropic (Claude), Amazon SageMaker AI (chat only — no tool calling), LiteLLM (100+ providers)
- 🔧 MCP Tool System: Extensible tool architecture via Model Context Protocol
- 📚 RAG: Automatic document indexing and semantic (hybrid) search
- 🧠 User Profile Learning: Personalized responses learned from interactions
- 🧩 Episodic Memory: Learns from successful task completions and retrieves similar solutions
- 📖 ACE Playbook: Learns strategies from successes AND failures (Agentic Context Engineering)
- 🔍 Web Search & 🌐 Crawler: Brave Search API + web page extraction with RAG ingestion
- 🖼️ Vision Support: Image analysis with vision models
- 📁 File Operations & ✏️ Precise Editing: Read/write/edit text, CSV, JSON, PDF, DOCX
- 🔎 Fast Search: Glob + ripgrep content search (10-100x faster)
- 📋 Todo Tracking, 📝 Plan Mode & 🔄 Background Tasks: Multi-step task management
- ⚡ Bash Execution & 🛡️ Git Safety: Shell commands with smart error handling and guardrails
📄 License
Licensed under the MIT License — see the LICENSE file for details.
🤝 Contributing
This is a personal development project. Feel free to fork and adapt it to your needs; attribution to the original repository is appreciated but not required.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mnemoai_assistant-1.10.1.tar.gz.
File metadata
- Download URL: mnemoai_assistant-1.10.1.tar.gz
- Upload date:
- Size: 1.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d5b96f515ab9c345409e6265a9e0ecdb7431a82b37cf2dcf2b6c04da928899de
|
|
| MD5 |
83d98b550a4d4967d3f93443e4f3e3a0
|
|
| BLAKE2b-256 |
8b32b702e6a84b658b5a98086f1902da63a6cb1ac0ca1a25d67e9d136756b6d0
|
File details
Details for the file mnemoai_assistant-1.10.1-py3-none-any.whl.
File metadata
- Download URL: mnemoai_assistant-1.10.1-py3-none-any.whl
- Upload date:
- Size: 472.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b24902523bafeb7864571ec3d695fb49c8b407e3304cc17c882a489c2d8c948
|
|
| MD5 |
c63e14f32c5c9287aecdd02f34bc5ae8
|
|
| BLAKE2b-256 |
acb7b6dda89a5c793fd59569bc92778244842c33d57094a51927815edf9e4973
|
