// rag · OpenBMB/UltraRAG

UltraRAG

A low-code MCP framework for building complex, innovative RAG pipelines — visibly, not as a black box.

★ 5.7k stars⑂ 450 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

UltraRAG is an open-source rag & knowledge project by OpenBMB (OpenBMB/UltraRAG on GitHub). It has 5,717 GitHub stars and 450 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 7 October 2026.

GitHub stars
5,717
Forks
450
License
Apache-2.0
Last updated on GitHub
7 October 2026
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your RAG pipeline

    Map the retrieval and generation steps you need — corpus processing, retriever, reranking, generation, evaluation.

  2. Clone and sync

    Clone the repo and sync dependencies with uv, choosing core, full or per-module extras.

  3. Configure models and corpus

    Point the pipeline at your embedding and LLM providers (for example OpenAI, Qwen or local vLLM) and prepare your corpus.

  4. Run your first pipeline

    Execute a bundled example experiment YAML, then open the UI to inspect each step's output.

// features

Why people love it

YAML-declared pipelines

Compose retrieval, generation and evaluation steps in a few dozen lines of YAML instead of hand-writing orchestration code.

MCP-based architecture

Built as a low-code MCP framework, so pipeline components interact through the Model Context Protocol.

Visible reasoning

Designed against black-box development: pipeline logic and intermediate results stay inspectable, including in the web UI.

Modular installation

Install only the modules you need with extras — retriever, generation, or the full stack with corpus processing and evaluation.

Multimodal and DeepResearch examples

Ships multimodal support and example pipelines including a lightweight DeepResearch setup.

Docker images published

Ready Docker images (base CPU, base GPU and full GPU) are published on Docker Hub for a fast start.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone UltraRAG (shallow) and enter the directory.

    git clone https://github.com/OpenBMB/UltraRAG.git --depth 1
    cd UltraRAG
  2. Sync dependencies

    Create the environment with uv; add --all-extras for the full feature set.

    uv sync
  3. Run an example pipeline

    Execute the hello-world experiment to verify the installation end to end.

    ultrarag run examples/experiments/sayhello.yaml
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains UltraRAG?

UltraRAG is maintained by OpenBMB, the team behind MiniCPM and related open models.

Is UltraRAG free?

Yes — it is open source under the Apache-2.0 license.

Does it need a paid API key?

It depends on your pipeline: hosted models (OpenAI and similar) need your key, while local models served with vLLM do not.

How does it compare to LangChain or LlamaIndex?

Those are general application frameworks; UltraRAG specializes in declarative, MCP-based RAG pipelines where every reasoning step remains visible and swappable.

How do I get started?

Clone the repo, run uv sync, and execute the sayhello example pipeline.

// keep exploring

Similar tools

RAG & Knowledge

llmware

Unified framework for enterprise RAG pipelines with small, specialized models - local, private and secure.

★ 14.8k starsApache-2.0
View guide →
RAG & Knowledge

code-graph-rag

RAG for your monorepo: query, understand and edit multi-language codebases with a knowledge graph.

★ 5.2k starsMIT
View guide →
RAG & Knowledge

qdrant-loader

Free rag & knowledge tool that enterprise-ready vector database toolkit for building s.

★ 55 starsApache-2.0
View guide →
RAG & Knowledge

docs-mcp

Self-hosted rag & knowledge: cometchat docs search + implementation bundles: add cha.

★ 97 starsApache-2.0
View guide →
RAG & Knowledge

private-gpt

Complete API layer for private AI apps on local models: RAG, skills, tools, MCP and text-to-SQL

★ 57.6k starsApache-2.0
View guide →
RAG & Knowledge

llm-app

Ready-to-run templates for RAG, AI pipelines and enterprise search that stay in sync with live data

★ 58.8k starsMIT
View guide →
// alternatives

Alternatives in RAG & Knowledge

The most-starred other RAG & Knowledge projects in the LibreAI catalogue — the realistic shortlist if UltraRAG is not the right fit.

Get UltraRAG

Free and open — grab the source, star the repo, and start creating.