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, MLX, 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
- Supervisor peer review
- Everyday tools
- Architecture
- Development
🚀 Quick Start
curl -fsSL https://raw.githubusercontent.com/brunopistone/mnemoai/main/install.sh | sh
mnemoai # verbose (shows thinking); --no-verbose to hide
macOS/Linux: the installer manages an isolated Python runtime; re-run it to update.
Follow its PATH hint if needed. Existing configuration and conversations stay in
~/.mnemoai. Prefer managing Python yourself? uv tool install mnemoai-assistant,
pipx install mnemoai-assistant, and pip install mnemoai-assistant still work.
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), MLX (local, Apple Silicon), 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
- 🪝 Tool Hooks: Your own commands run before/after any tool call — format writes, deny paths, auto-approve safe commands (docs)
- ⌨️ Your Own Slash Commands: A markdown file per prompt you retype —
commands/review.mdbecomes/review <path>(docs) - 📎
@-File Mentions: Type@to complete a path anywhere in your prompt; the file is read and sent with the question (docs) - ⟲ Take Back a Prompt:
/rewinddrops your last prompt and everything the turn produced — the conversation only, files on disk untouched (docs) - 🗂️ Workspace Reports:
/fileslists what the session read, changed or attached;/diffshows uncommitted changes with this session's edits marked;/why <path>names the prompt behind each change to a file, across sessions;/copyputs the last answer on the clipboard without the terminal's wrapping (docs)
📄 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
Metadata
1 maintainer
Release files for mnemoai-assistant 1.29.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mnemoai_assistant-1.29.0.tar.gz | 2.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mnemoai_assistant-1.29.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.4 MB
Release files / mnemoai_assistant-1.29.0.tar.gz
| Download URL | mnemoai_assistant-1.29.0.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
624c333f77360a71afc61fb0fefc603e33667a3cf8449fa9fe913f242da48475
|
|
BLAKE2b-256 checksum How to use checksums |
be34f7792db9dddbbfc1979af8f6e1fd4c7b5d715fb04d4299b0cdb7f1649738
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / mnemoai_assistant-1.29.0-py3-none-any.whl
| Download URL | mnemoai_assistant-1.29.0-py3-none-any.whl |
|---|---|
| Size | 745.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d7e99e7adf0e40657342b4004f6bfeca1a6c6308c4d8e614653b965e57cedab
|
|
BLAKE2b-256 checksum How to use checksums |
32d0af6c192b30e9a92e106ab57b036124b7b737549e2c7f660b06479b04186f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
