MCPcopy Index your code
hub / github.com/ragapp/ragapp

github.com/ragapp/ragapp @v0.1.5 sqlite

repository ↗ · DeepWiki ↗ · release v0.1.5 ↗
527 symbols 1,934 edges 190 files 55 documented · 10%
README

Logo - RAGapp

The easiest way to use Agentic RAG in any enterprise.

As simple to configure as OpenAI's custom GPTs, but deployable in your own cloud infrastructure using Docker. Built using LlamaIndex.

Get Started · Endpoints · Deployment · Contact

Screenshot

Get Started

To run, start a docker container with our image:

docker run -p 8000:8000 ragapp/ragapp

Then, access the Admin UI at http://localhost:8000/admin to configure your RAGapp.

You can use hosted AI models from OpenAI or Gemini, and local models using Ollama.

Note: To avoid running into any errors, we recommend using the latest version of Docker and (if needed) Docker Compose.

Endpoints

The docker container exposes the following endpoints:

  • Admin UI: http://localhost:8000/admin
  • Chat UI: http://localhost:8000
  • API: http://localhost:8000/docs

Note: The Chat UI and API are only functional if the RAGapp is configured.

Security

Authentication

Just the RAGapp container doesn't come with any authentication layer by design. This is the task of an API Gateway routing the traffic to RAGapp. This step heavily depends on your cloud provider and the services you use. For a pure Docker Compose environment, you can look at our RAGapp with management UI deployment.

Authorization

Later versions of RAGapp will support restricting access based on access tokens forwarded from an API Gateway or similar.

Deployment

Using Docker Compose

You can easily deploy RAGapp to your own infrastructure with one of these Docker Compose deployments:

  1. RAGapp with Ollama and Qdrant
  2. Multiple RAGapps with a management UI

Kubernetes

It's easy to deploy RAGapp in your own cloud infrastructure. Customized K8S deployment descriptors are coming soon.

Development

RAGApp:

Important: Parts of this project's source code is dynamically retrieved from the create-llama project. Before committing changes, make sure to update the source code by calling make build-frontends.

Move to src/ragapp directory and start with these commands:

export ENVIRONMENT=dev
poetry install --no-root
make build-frontends
make dev

Then, to check out the admin UI, go to http://localhost:3000/admin.

Note: Make sure you have Poetry installed.

Contact

Questions, feature requests or found a bug? Open an issue or reach out to marcusschiesser.

Star History

Star History Chart

Extension points exported contracts — how you extend this code

TextareaProps (Interface)
(no doc)
src/ragapp/admin-ui/components/ui/textarea.tsx
InputProps (Interface)
(no doc)
src/manager/frontend/src/components/ui/input.tsx
InputProps (Interface)
(no doc)
src/ragapp/admin-ui/components/ui/input.tsx
ButtonProps (Interface)
(no doc)
src/manager/frontend/src/components/ui/button.tsx
State (Interface)
(no doc)
src/ragapp/admin-ui/components/ui/use-toast.ts
ButtonProps (Interface)
(no doc)
src/ragapp/admin-ui/components/ui/button.tsx
CreateAgentPopupProps (Interface)
(no doc)
src/ragapp/admin-ui/sections/config/agents/CreateAgentPopup.tsx

Core symbols most depended-on inside this repo

cn
called by 43
src/ragapp/admin-ui/lib/utils.ts
cn
called by 28
src/manager/frontend/src/lib/utils.ts
getBaseURL
called by 24
src/ragapp/admin-ui/client/utils.ts
handleSaveChanges
called by 22
src/ragapp/admin-ui/sections/config/agent.tsx
toast
called by 16
src/ragapp/admin-ui/components/ui/use-toast.ts
to_api_response
called by 8
src/ragapp/backend/models/chat_config.py
update
called by 7
src/ragapp/backend/controllers/env_configs.py
get_index
called by 7
src/ragapp/patch/backend/app/engine/index.py

Shape

Function 251
Method 149
Class 80
Route 37
Interface 10

Languages

Python69%
TypeScript31%

Modules by API surface

src/ragapp/backend/controllers/agents.py22 symbols
src/ragapp/backend/workflows/planner.py20 symbols
src/ragapp/backend/routers/management/agents.py18 symbols
src/ragapp/backend/routers/chat/vercel_response.py18 symbols
src/ragapp/backend/workflows/single.py14 symbols
src/ragapp/backend/tests/test_agent_manager.py14 symbols
src/ragapp/backend/models/model_config.py13 symbols
src/ragapp/patch/backend/app/engine/service.py12 symbols
src/ragapp/backend/routers/management/config.py12 symbols
src/ragapp/admin-ui/sections/config/fileLoader.tsx10 symbols
src/manager/app/routers/services.py10 symbols
src/ragapp/backend/tests/test_engine.py9 symbols

Dependencies from manifests, versioned

@changesets/cli2.27.1 · 1×
@hookform/resolvers3.6.0 · 1×
@radix-ui/react-alert-dialog1.1.1 · 1×
@radix-ui/react-avatar1.1.0 · 1×
@radix-ui/react-checkbox1.0.4 · 1×
@radix-ui/react-dialog1.0.5 · 1×
@radix-ui/react-label2.0.2 · 1×
@radix-ui/react-slot1.0.2 · 1×
@radix-ui/react-switch1.1.0 · 1×

For agents

$ claude mcp add ragapp \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact