Self-hosted RAG engine for AI coding assistants. Ingests technical docs & code repositories locally with structure-aware chunking. Serves grounded context via MCP to prevent hallucinations in software development workflows.
星标
16
工具
—
可用率
—
📖 About
Qurio is a self-hosted, open-source ingestion and retrieval engine that functions as a local Shared Library for AI coding assistants (like Gemini-CLI, Claude Code, Cursor, Windsurf, or custom scripts).
Unlike cloud-based RAG solutions that introduce latency and privacy risks, Qurio runs locally to ingest your handpicked heterogeneous documentation (web crawls, PDFs, Markdown) and serves it directly to your agents via the Model Context Protocol (MCP). This ensures your AI writes better code faster using only the context you trust.
Qurio features a custom structural chunker that respects code blocks, API definitions, and config files, preserving full code blocks and syntaxes.
Why Qurio?
Privacy First: Your data stays on your machine (localhost).
Precision: Retrieves grounded "truth" to prevent AI hallucinations.
Speed: Deploys in minutes with docker-compose.
Open Standards: Built on MCP, Weaviate, and PostgreSQL.
Add API Keys:
Access http://localhost:3000/settings page in the dashboard, and add your Gemini and JinaAI/Cohoere(optional) API Keys
Configuration
Configuration is managed via the Settings page in the UI or environment variables.
Variable
Description
Default
GEMINI_API_KEY
Key for Google Gemini (Embeddings)
Required
RERANK_PROVIDER
none, jina, cohere
none
RERANK_API_KEY
API Key for selected provider
-
SEARCH_ALPHA
Hybrid search balance (0.0=Keyword, 1.0=Vector)
0.5
SEARCH_TOP_K
Max results to return
5
💡 Usage
[!TIP]
Unlock the full potential of your Agent
Check out the Agent Prompting Guide for best practices, workflow examples, and system prompt templates (CLAUDE.md, GEMINI.md) to paste into your project.
Note: Qurio uses a stateless, streamable HTTP transport at http://localhost:8081/mcp. Use a client that supports native HTTP MCP connections.
3. Query
Ask your AI agent a question. It will now have access to the documentation you indexed!
"How do I configure a healthcheck in Docker Compose?"
4. Available Tools
Once connected, your agent will have access to the following tools:
Tool
Description
qurio_search
Search your knowledge base. Supports hybrid search (keywords + vectors). Use this to find relevant documentation or code examples.
qurio_list_sources
List all available data sources. Useful to see what documentation is currently indexed.
qurio_list_pages
List pages within a source. Helpful for exploring the structure of a documentation site.
qurio_read_page
Read a full page. Retrieves the complete content of a specific document or web page found via search or listing.
5. Roadmap
Rework crawler & embedder parallelization
Migrate to Streamable HTTP
Supports multiple different models beyond Gemini
Supports more granular i.e. section by section page retrieval
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Q
Qurio
irahardianto·16 个星标·
Self-hosted RAG engine for AI coding assistants. Ingests technical docs & code repositories locally with structure-aware chunking. Serves grounded context via MCP to prevent hallucinations in software
Self-hosted RAG engine for AI coding assistants. Ingests technical docs & code repositories locally with structure-aware chunking. Serves grounded context via MCP to prevent hallucinations in software development workflows.
上次检查时间:2026-10-28。 Self-hosted RAG engine for AI coding assistants. Ingests technical docs & code repositories locally with structure-aware chunking. Serves grounded context via MCP to prevent hallucinations in software development workflows.