Metadata-Version: 2.4
Name: mnemoai-assistant
Version: 0.8.3
Summary: Mnemo AI — a local agentic AI assistant (LangGraph + MCP) that learns and remembers, with multi-provider model support.
Project-URL: Homepage, https://github.com/brunopistone/mnemoai
Project-URL: Repository, https://github.com/brunopistone/mnemoai
Project-URL: Issues, https://github.com/brunopistone/mnemoai/issues
Author: Bruno Pistone
License-Expression: MIT
License-File: LICENSE
Keywords: agent,assistant,bedrock,cli,langgraph,llm,mcp,ollama,rag
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: aws-bedrock-token-generator>=1.1.0
Requires-Dist: boto3>=1.42.78
Requires-Dist: brave-search-python-client>=0.4.27
Requires-Dist: chromadb>=1.5.5
Requires-Dist: crawl4ai>=0.8.6
Requires-Dist: faiss-cpu>=1.13.2
Requires-Dist: httpx>=0.28.1
Requires-Dist: langchain-anthropic>=1.4.4
Requires-Dist: langchain-aws>=1.4.1
Requires-Dist: langchain-core>=1.2.23
Requires-Dist: langchain-litellm>=0.3.5
Requires-Dist: langchain-ollama>=1.0.1
Requires-Dist: langchain-openai>=1.1.12
Requires-Dist: langgraph>=1.1.3
Requires-Dist: litellm>=1.81.1
Requires-Dist: mcp[cli]>=1.26.0
Requires-Dist: mem0ai>=1.0.9
Requires-Dist: mypy-boto3-sagemaker-runtime>=1.42.54
Requires-Dist: numpy>=2.4.4
Requires-Dist: ollama>=0.6.1
Requires-Dist: openai>=2.30.0
Requires-Dist: prompt-toolkit>=3.0.52
Requires-Dist: psutil>=7.2.2
Requires-Dist: pygments>=2.20.0
Requires-Dist: pypdf2>=3.0.1
Requires-Dist: python-docx>=1.2.0
Requires-Dist: qdrant-client>=1.17.1
Requires-Dist: tiktoken>=0.12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/brunopistone/mnemoai/main/images/mnemoai-logo.png" alt="Mnemo AI" width="120">
</p>

<h1 align="center">Mnemo AI</h1>

[![PyPI](https://img.shields.io/pypi/v/mnemoai-assistant.svg)](https://pypi.org/project/mnemoai-assistant/)
[![Python Version](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

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, OpenAI, Anthropic, Amazon SageMaker AI, LiteLLM).

![Demo](https://raw.githubusercontent.com/brunopistone/mnemoai/main/images/assistant-demo.gif)

## 📖 Documentation

Full documentation is available at **https://brunopistone.github.io/mnemoai/**

- [Getting Started](https://brunopistone.github.io/mnemoai/getting-started/)
- [Usage](https://brunopistone.github.io/mnemoai/usage/)
- [Configuration](https://brunopistone.github.io/mnemoai/configuration/)
- [Advanced Features](https://brunopistone.github.io/mnemoai/advanced-features/)
- [Productivity Tools](https://brunopistone.github.io/mnemoai/productivity/)
- [Architecture](https://brunopistone.github.io/mnemoai/architecture/)
- [Development](https://brunopistone.github.io/mnemoai/development/)

## 🚀 Quick Start

```bash
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](https://brunopistone.github.io/mnemoai/getting-started/) for full setup.

## ✨ Key Features

- **🤖 Multi-Model Support**: Ollama (local), Amazon Bedrock, OpenAI, Anthropic (Claude), Amazon SageMaker AI, 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.
