AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
RAG / Knowledge Base/
minima
minima logo

minima

Active·★ 1.1k·MPL-2.0·Updated 2026-01-22

Minima is an open-source RAG system that runs in containers on your own machine or cloud. It indexes a local folder and lets you ask questions about the documents, with four ways to connect the answering model.

In the fully local mode, everything (the LLM, the reranker and the embedding model) runs through Ollama in your containers, with no external services. A custom-LLM mode keeps the indexer local and uses any OpenAI-compatible endpoint such as vLLM, an Ollama server or TGI. A Custom GPT mode lets you query your documents from the ChatGPT app, and an MCP mode lets the Claude desktop app use Minima's MCP server while the indexer stays on your machine.

The easiest start is `./run.sh`, which offers the four options in a menu; alternatively you fill in `.env` (local files path, embedding model and size, and the model settings for your mode) and run the matching Docker Compose file. GitHub does not detect a licence, and our data shows the last push on 2026-01-22.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-20.

License
MPL-2.0
Latest release
No GitHub releases
Last commit
2026-01-22
Contributors
11
Forks
109
Open issues and PRs
15
First published
2024-11-02

Source: GitHub, npm and PyPI public APIs.

#RAG#On-premises#LLM#Docker#AI
$ Install
$ ./run.sh
↗ Visit site★ GitHub
01

Features

01Open-source RAG solution for on-premises container deployment.
02Supports fully local operation with Ollama, ensuring data privacy and security.
03Integrates with custom LLMs via OpenAI-compatible APIs (e.g., vLLM, TGI).
04Enables querying local documents using ChatGPT or Anthropic Claude applications.
05Indexes various document types including PDF, DOCX, TXT, MD, and CSV.
02

Why choose it

+A fully local mode where documents, embeddings, reranking and the LLM never leave your containers.
+The same index can answer through Ollama, any OpenAI-compatible LLM, ChatGPT or Claude via MCP.
+Menu-driven start with run.sh, or explicit Docker Compose files per mode.
03

Trade-offs

!In the ChatGPT and Claude modes, retrieved passages are sent to those services.
!The fully local mode needs enough hardware to run an LLM, a reranker and an embedding model.
!GitHub does not detect a licence, and our data shows the last push on 2026-01-22.
04

Maintenance check

SlowingChecked: 2026-11-06
Last commit
2026-01-22
Commits, last 90 days
0
Releases, last 90 days
0
Latest release
beta (2025-01-22)
Open issues
16
Recent issues with at least one comment
5/17
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #36 Chat gives no answer4 comments · 2025-02-21
  • #11 Problem in vector DB.2 comments · 2024-12-04
  • #57 Minima (Local RAG) has a Nerq Trust Score of 69.8/100 — verified badge available0 comments · 2026-05-12
  • #56 Your project is listed on Spark — claim your listing0 comments · 2026-03-31
  • #49 llm ERROR: Exception in ASGI application after startup0 comments · 2025-06-24

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Ollama
Native
Verified via docs
OpenAI-compatible LLM APIs
Supported
Verified via docs
ChatGPT
Supported
Verified via docs
Anthropic Claude
Supported
Verified via docs
GitHub Copilot
Partial
Verified via docs
06

Quick start

1
$ ./run.sh
07

Use cases

↳Building secure, fully on-premises RAG systems using local LLMs like Ollama.
↳Integrating proprietary or self-hosted LLMs into a RAG workflow via OpenAI-compatible APIs.
↳Enhancing ChatGPT or Anthropic Claude with the ability to query and retrieve information from personal or organizational local documents.
08

Alternatives

⚡Top VS:
VSragflow★94.5k→VSMaxKB★23.2k→VSAgentGuide★12.2k→VSgenerative-ai★2.7k→
ragflow logo
ragflow★ 94.5k
RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fuses cutting-edge RAG with Agent capabilities to create a superior context layer for LLMs
VSCompare→
MaxKB logo
MaxKB★ 23.2k
An open-source platform for building enterprise-grade agents. Powerful and easy to use.
VSCompare→
AgentGuide logo
AgentGuide★ 12.2k
https://adongwanai.github.io/AgentGuide | AI Agent开发指南 | LangGraph实战 | 高级RAG | 转行大模型 | 大模型面试 | 算法工程师 | 面试题库 | 强化学习|数据合成
VSCompare→
generative-ai logo
generative-ai★ 2.7k
Comprehensive resources on Generative AI, including a detailed roadmap, projects, use cases, interview preparation, and coding preparation.
VSCompare→
solon-ai logo
solon-ai★ 473
Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.
awesome-azure-openai-llm logo
awesome-azure-openai-llm★ 423
A curated collection of resources for 🌌 Azure OpenAI, 🦙 LLMs (RAG, Agents).
glean logo
glean★ 875
A self-hosted RSS reader and personal knowledge management tool.
MCP-Bridge logo
MCP-Bridge★ 922
A middleware to provide an openAI compatible endpoint that can call MCP tools
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
dmayboroda /
minima
↗

On-premises RAG in containers that can run fully local with Ollama or answer through ChatGPT, Claude via MCP, or your own LLM

1.1k109MPL-2.0
Last commit10mo ago
StatusActive
CategoryRAG / Knowledge Base
Contributors11
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.