// rag · ragapp/ragapp

ragapp

RAGApp: deploy a RAG app over your documents with Docker — configure it like a custom GPT

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

Project facts

ragapp is an open-source rag & knowledge project by ragapp (ragapp/ragapp on GitHub). It has 4,446 GitHub stars and 471 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 22 January 2025.

Repository
ragapp/ragapp
GitHub stars
4,446
Forks
471
License
Apache-2.0
Last updated on GitHub
22 January 2025
Listing
Full install guide
// how it works

How it works

  1. Gather your data

    Collect the documents or sources you want the app to answer questions over.

  2. Run the container

    Start RAGApp with a single docker run command.

  3. Configure in the admin UI

    Open the admin page to connect your data and choose a model — OpenAI, Gemini, or local Ollama.

  4. Chat and share

    Use the chat UI at the root URL, and put the app behind your API gateway if exposing it publicly.

// features

Why people love it

One-command deployment

A single `docker run` starts the whole app on port 8000.

Admin UI configuration

Set up data sources and models from the browser, like configuring a custom GPT.

Chat UI and API docs included

A user-facing chat interface at / and interactive API documentation at /docs.

Hosted or local models

Use OpenAI or Gemini with your key, or run fully local models through Ollama.

Compose variants for production

Provided Docker Compose setups add Ollama + Qdrant, or a management UI to run multiple RAG apps.

Built on LlamaIndex

Retrieval and indexing ride on the LlamaIndex framework's data connectors and pipelines.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory (for development or Compose deployments).

    git clone https://github.com/ragapp/ragapp.git
    cd ragapp
  2. Run the container

    Start RAGApp with Docker, publishing port 8000.

    docker run -p 8000:8000 ragapp/ragapp
  3. Configure your app

    Open the admin UI and connect your data and model.

    # open http://localhost:8000/admin — chat UI at http://localhost:8000/
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains RAGApp?

The ragapp project team; it is built on top of LlamaIndex.

Is RAGApp free?

Yes, Apache-2.0 licensed. Hosted model usage (OpenAI/Gemini) bills to your own keys; local Ollama models avoid that.

Does it need a paid API key?

Only if you choose hosted models. With Ollama configured, the app can run entirely on local models.

How does it compare to building RAG with LlamaIndex directly?

RAGApp packages the LlamaIndex plumbing into a deployable app with admin and chat UIs, trading deep customization for minutes-to-working setup.

How do I get started?

Run `docker run -p 8000:8000 ragapp/ragapp`, then configure data and models at http://localhost:8000/admin.

// keep exploring

Similar tools

RAG & Knowledge

PageIndex

PageIndex: vectorless, reasoning-based RAG that indexes documents like a human expert would

★ 39.0k starsMIT
View guide →
RAG & Knowledge

knowhere

Knowhere turns documents into structured, hierarchy-native chunks ready for agents and RAG.

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

DocsGPT

A private AI platform for agents, assistants and enterprise search over your documents

★ 18.3k starsMIT
View guide →
RAG & Knowledge

LEANN

The smallest vector index in the world: private RAG over everything on your laptop with 97% less storage.

★ 13.0k starsMIT
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

Dify

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or…

★ 157.8k starsCustom (check repo)
View guide →
// alternatives

Alternatives in RAG & Knowledge

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

Get ragapp

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