whatisgithub

What is clawrag?

2dogsandanerd/clawrag — explained in plain English

Analysis updated 2026-05-18

147PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A self-hosted document question-answering system that lets you upload files and ask questions grounded in their content, without sending data to the cloud.

Mindmap

mindmap
  root((ClawRAG))
    What it does
      Self-hosted document QA
      Vector database search
      Local AI answers
    Tech Stack
      Python
      Docker
      ChromaDB
    Use Cases
      Legal document review
      Medical research analysis
      Financial due diligence
    Audience
      Developers
      Enterprises

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask questions against your own PDFs, Word documents, and CSVs without sending data to a third party

USE CASE 2

Review legal and compliance documents like contracts and regulatory filings locally

USE CASE 3

Search technical documentation and manuals using hybrid semantic and keyword search

USE CASE 4

Analyze medical research literature or financial due diligence documents on your own infrastructure

What is it built with?

PythonDockerChromaDBFastAPIVue.js

How does it compare?

2dogsandanerd/clawrageesjgong/graph-cadmurphylmf/unish
Stars147147145
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/55/55/5
Audiencedeveloperresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker Compose and at least 8GB RAM to run the full stack.

The community edition is free to use under the MIT license, which allows commercial use as long as you keep the copyright notice.

So what is it?

ClawRAG is a self-hosted document question-answering system you run entirely on your own computer or server. It combines document processing with a vector database (a type of database optimized for finding conceptually similar content) and a local AI model, so your documents never need to leave your infrastructure. You upload files, PDFs, Word documents, text files, CSVs, and more, and the system extracts their content, breaks it into searchable chunks, and stores them in a local vector database called ChromaDB. When you ask a question, it finds the most relevant passages using a hybrid search that combines semantic meaning with keyword matching, then passes those passages to an AI model to generate an answer grounded in your actual documents. The system runs entirely through Docker (a containerization tool), meaning you can get it running with a single command. It ships with a web interface for browsing and querying, plus a REST API for developers who want to integrate it with other tools. A free community edition handles PDF, Word, Markdown, text, and CSV files. An enterprise tier (in a separate repository) adds support for more file formats, multiple parallel processing engines that cross-check each other's output for accuracy, graph-based relationship traversal across documents, and multi-tenant isolation. Intended use cases include legal and compliance document review, medical research analysis, financial due diligence, and technical documentation search. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Walk me through setting up ClawRAG locally with Docker Compose and querying my first document
Prompt 2
Explain how ClawRAG's hybrid search combines semantic and keyword matching to find relevant passages
Prompt 3
Show me how to call ClawRAG's REST API to upload a document and ask a question about it
Prompt 4
Compare what the free community edition of ClawRAG offers versus the enterprise edition

Frequently asked questions

What is clawrag?

A self-hosted document question-answering system that lets you upload files and ask questions grounded in their content, without sending data to the cloud.

What language is clawrag written in?

Mainly Python. The stack also includes Python, Docker, ChromaDB.

What license does clawrag use?

The community edition is free to use under the MIT license, which allows commercial use as long as you keep the copyright notice.

How hard is clawrag to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is clawrag for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.