Ask questions about your private documents using local AI.
A

Ask questions about your private documents using local AI.

Ask questions about your private documents using local AI.

57,305 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Ask Your Docs: PrivateGPT Brings Local AI to Your Documents

Ever wished you could just ask a question and have an AI scan your entire collection of PDFs, text files, or presentations for the answer? The catch is, you probably don't want to upload all that sensitive, private information to a third-party API. That's the exact problem PrivateGPT solves.

This project by imartinez drops a powerful, local question-answering bot right onto your machine. It ingests your documents, builds a searchable knowledge base, and lets you query it—all without an internet connection or data ever leaving your computer.

What It Does

PrivateGPT is a production-ready Python application that uses large language models (LLMs) to answer questions based on the content of your local documents. You feed it a folder of files (supports PDF, CSV, Word, PowerPoint, text, and more), and it processes and stores them locally using embeddings. When you ask a question, it finds the most relevant chunks from your documents and uses an LLM to generate a coherent, cited answer.

Why It's Cool

The "private" part is the real headline. Everything runs locally, powered by libraries like LangChain, GPT4All, LlamaCpp, and Chroma for the vector store. You can use it for sensitive codebases, internal company memos, personal research, or proprietary data without a second thought about privacy or compliance.

It's also impressively self-contained. The project leverages powerful, open-source models that you download and run on your own hardware. While you'll need a decent machine (it recommends at least 16GB of RAM for the full experience), the setup means you own the entire pipeline. The answers it provides include references to the source documents, so you can double-check the AI's work—a crucial feature for serious use.

How to Try It

Getting started is straightforward if you're comfortable with a terminal and Python. Head over to the PrivateGPT GitHub repository for the full details.

  1. Clone the repo and install the dependencies (a requirements.txt is provided).
  2. Download the LLM model. The instructions will point you to the specific GPT4All model file to download and place in the project directory.
  3. Drop your documents into the source_documents folder.
  4. Run the ingestion script (python ingest.py) to process your files into the local vector database.
  5. Finally, fire up the main script (python privateGPT.py) and start asking questions in your terminal.

The repo has a solid README that walks you through each step, including how to customize the model and tweak settings for pe

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Dec 27, 2025