git404hub

what is ragit fr?

ats4321/ragit — explained in plain English

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 2/5Setup · moderate

tl;dr

A local command-line tool that lets you chat with any folder of documents using Ollama AI models, with no API keys or cloud required.

vibe map

mindmap
  root((ragit))
    What it does
      Chat with documents
      Local only no cloud
      Shows source chunks
    How it works
      Index folder
      Embed with Ollama
      Store in ChromaDB
      Retrieve and answer
    Supported files
      txt md pdf docx
    Commands
      index chat clear models

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 make with this?

VIBE 1

Ask questions about a folder of project docs, notes, or PDFs in plain language and get sourced answers.

VIBE 2

Index a local knowledge base and query it conversationally without an internet connection or API key.

VIBE 3

Switch between different local Ollama models to compare answer quality on your documents.

VIBE 4

Clear and rebuild the index for a folder after adding new files.

what's the stack?

PythonOllamaChromaDBllama3.2nomic-embed-text

how it stacks up fr

ats4321/ragitadeliox/klein-head-swapaudiohacking/audiogen.cpp
Stars444
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/53/54/5
Audiencedeveloperdesignerdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Ollama installed and running, plus Python 3.10 to 3.13 (not 3.14+).

in plain english

ragit is a command-line tool that lets you have a conversation with a folder of documents on your own computer. You point it at a folder containing text files, Markdown files, PDFs, or Word documents, and then ask questions in plain language. It finds the relevant parts of those documents and uses a local AI model to write an answer, showing you which document sections it pulled from. The tool uses a technique called Retrieval-Augmented Generation (RAG). When you run the index command, ragit reads all supported files in a folder, breaks them into overlapping chunks of roughly 500 words each, and converts those chunks into numerical vectors using a local model called nomic-embed-text. Those vectors are stored in a local database called ChromaDB, which keeps everything on your machine. When you ask a question during chat, ragit converts your question into a vector, finds the most similar document chunks, and feeds them to a local chat model to produce an answer. Everything runs locally. No API key is needed, no files leave your machine, and no internet connection is required after the initial model downloads. The default chat model is llama3.2, but any model installed in Ollama will work. Both Ollama (the tool that runs local AI models) and Python 3.10 to 3.13 are required. The three main commands are concise: ragit index <folder> scans and indexes documents, ragit chat <folder> starts the conversation, and ragit clear <folder> removes the stored index. A ragit models command lists available Ollama models. The README is brief and does not cover performance, folder size limits, or configuration options beyond these basics.

prompts (copy fr)

prompt 1
How do I install ragit and set up Ollama with the nomic-embed-text model so I can index my documents?
prompt 2
How do I index a folder of PDFs and start chatting with them using ragit?
prompt 3
Can I use a different Ollama model instead of llama3.2 with ragit, and how do I set that up?
prompt 4
How does ragit decide which document chunks to include in an answer and how can I see the sources it used?

Frequently asked questions

what is ragit fr?

A local command-line tool that lets you chat with any folder of documents using Ollama AI models, with no API keys or cloud required.

What language is ragit written in?

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

How hard is ragit to set up?

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

Who is ragit for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.