// rag · nageoffer/ragent

ragent

Ragent (容纳智能体): a production-grade Java Agentic RAG platform with hybrid retrieval and an admin console

★ 4.2k stars⑂ 848 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

ragent is an open-source rag & knowledge project by nageoffer (nageoffer/ragent on GitHub). It has 4,208 GitHub stars and 848 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 7 October 2026.

GitHub stars
4,208
Forks
848
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. Review the architecture

    Read the overview of the seven Maven modules and the infrastructure you will need (database, Redis, vector store).

  2. Clone the project

    Get the backend and console source from GitHub.

  3. Follow the official quick-start

    Build and run the platform using the step-by-step guide on the docs site, configuring your LLM providers.

  4. Ingest and ask

    Use the admin console to ingest documents into a knowledge base and run your first cited query.

// features

Why people love it

Parallel hybrid retrieval

Vector, keyword, knowledge-graph, and web search run together, then dedup, RRF fusion, and reranking produce the final context.

Query understanding

Query mapping, rewriting, and splitting, plus a tree-shaped intent recognizer that routes across multiple knowledge bases.

Model tiering and resilience

Multiple model tiers with first-token probing and circuit-breaker fallback when a provider degrades.

MCP tool use

AgentScope-based discovery and calling of MCP tools as part of answering.

Production traffic controls

Redis fair queueing and distributed concurrency limits keep shared deployments stable under load.

Console and traceability

A React admin console, answer sourcing/citations, feedback capture, and Langfuse tracing.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory.

    git clone https://github.com/nageoffer/ragent.git
    cd ragent
  2. Follow the official quick-start

    Environment setup, configuration, and run commands are maintained on the project's documentation site.

    # see the quick-start guide at nageoffer.com/ragent for the exact commands
  3. Open the console

    Start the backend and console per the guide, then sign in to ingest documents and test queries.

    # see the quick-start guide for service URLs and default credentials
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Ragent?

Developer nageoffer maintains Ragent and its documentation site.

Is Ragent free?

Yes, Apache-2.0 licensed; you run it on your own infrastructure and supply LLM provider keys.

Does it need a paid API key?

It needs LLM (and typically embedding) provider access configured per the quick-start guide; costs depend on the providers you choose.

How does it compare to Dify or RAGFlow?

Those are broad low-code platforms; Ragent is a code-first Java/Spring platform focused on retrieval quality, model resilience, and production traffic controls that Java teams can extend directly.

How do I get started?

Clone the repo and follow the quick-start guide at nageoffer.com/ragent to configure providers, start the services, and ingest your first knowledge base.

// keep exploring

Similar tools

RAG & Knowledge

Local_Pdf_Chat_RAG

Transparent Python RAG reference with FAISS + BM25 hybrid retrieval.

★ 957 starsMIT
View guide →
RAG & Knowledge

rag.computer

Rag.computer — self-hostable rag platform - document ingestion, embedd, open-source.

★ 100 starsMIT
View guide →
RAG & Knowledge

gno

Local AI-driven document search and editing with first-in-class hybrid retrieval

★ 115 starsMIT
View guide →
RAG & Knowledge

ezdata

AI-native data platform: 60+ connectors, ETL, scheduling, and RAG search.

★ 293 starsMIT
View guide →
RAG & Knowledge

vespa

Vespa — the AI search platform: vector, text and tensor search at production scale.

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

trieve

All-in-one API platform for search, recommendations, RAG and analytics — self-hostable

★ 2.7k starsMIT
View guide →
// alternatives

Alternatives in RAG & Knowledge

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

Get ragent

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