Practical overview
When it fits
Use it when you want a locally run, PDF-focused question-answering interface and can configure its model and embeddings.
Who it is for
- Readers who need to ask questions about PDF documents and refer back to relevant pages.
- Developers seeking a self-hosted Python starting point for a PDF question-answering chatbot.
Documented uses
- Ask questions about content extracted from uploaded PDFs.
- Keep a conversation history while researching a document.
- Locate the PDF pages associated with generated answers.
- Configure the Hugging Face model and embeddings used by the application.
Requirements & limits
The repository is public and identifies the project as Apache-2.0 licensed; its README documents running the application locally.
- The application is documented as a local run using
python app.pyfrom thesrcdirectory. - Model and embedding details are specified in
config.yamland may need updating for a different choice. - The documented stack includes Gradio, LangChain, ChromaDB, Hugging Face, and Llama 2.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up and open the chatbot locally
Install the project dependencies and start the Gradio PDF chatbot from the repository.
Before you start
- Python project checkout
- Dependencies listed in requirements.txt
- Model and embeddings details configured in config.yaml
Steps
Install dependencies with the command below.
pip install -r requirements.txtSet the Hugging Face model and embeddings details in
config.yamlas needed.Change into the
srcdirectory.Run the command below.
python app.py
Expected outcome
The README's documented local startup path for the chatbot interface.
Guide limitations
- The README does not specify hardware requirements or guarantee compatibility for particular model and embedding configurations.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- Niez-Gharbi/PDF-RAG-with-Llama2-and-Gradio · Official homepage title · retained in its source language

