# minima

> MCP Client

Minima is an open-source RAG platform offering on-premises containerized solutions, integrating with ChatGPT and MCP, or operating fully locally. It enables secure querying of local documents using various LLMs.

## Overview

- **Category:** AI
- **Language:** Python
- **Stars:** 1047
- **Forks:** 64
- **Owner:** dmayboroda
- **GitHub:** https://github.com/dmayboroda/minima
- **Created:** 2024-11-02T22:44:56+00:00
- **Updated:** 2025-03-28T12:00:49+00:00
- **Source:** https://model-context-protocol.com/clients/on-premises-rag-configurable-container-platform

## Setup

## Setup

1.  Create a .env file in the project’s root directory and copy all environment variables from env.sample to .env.
2.  Ensure your .env file includes the following variables: LOCAL_FILES_PATH, EMBEDDING_MODEL_ID, EMBEDDING_SIZE, OLLAMA_MODEL, RERANKER_MODEL, USER_ID, and PASSWORD.
3.  For fully local installation use: **docker compose -f docker-compose-ollama.yml --env-file .env up --build**.
4.  For ChatGPT enabled installation use: **docker compose -f docker-compose-chatgpt.yml --env-file .env up --build**.
5.  For MCP integration (Anthropic Desktop app usage): **docker compose -f docker-compose-mcp.yml --env-file .env up --build**.
6.  In case of ChatGPT enabled installation copy OTP from terminal where you launched docker and use [Minima GPT](https://chatgpt.com/g/g-r1MNTSb0Q-minima-local-computer-search).
7.  If you use Anthropic Claude, add the provided configuration to **/Library/Application\ Support/Claude/claude_desktop_config.json**.
8.  To use fully local installation go to `cd electron`, then run `npm install` and `npm start` which will launch Minima electron app.
9.  Ask anything, and you'll get answers based on local files in {LOCAL_FILES_PATH} folder.
10. To use a chat ui, please navigate to **http://localhost:3000**
11. To install Minima for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/minima) use: `npx -y @smithery/cli install minima --client claude`.
12. For MCP usage, ensure your local machine's python is >=3.10 and 'uv' is installed.

## Tools

## Available Tools

1.  **Isolated installation** (Operate fully on-premises with containers, free from external dependencies.)
2.  **Custom GPT** (Query your local documents using ChatGPT app or web with custom GPTs.)
3.  **Anthropic Claude** (Use Anthropic Claude app to query your local documents.)
4.  **Indexing** (Recursively indexes documents within subfolders of the specified root folder.)
5.  **Reranking** (Uses reranker models to improve search results.)
6.  **Smithery Integration** (Automated installation for Claude Desktop.)