---
title: PDF Chatbot
emoji: 📄
colorFrom: green
colorTo: red
sdk: streamlit
sdk_version: 1.45.1
app_file: app.py
pinned: false
---

# PDF Chatbot with LLaMA

![Python 3.12](https://img.shields.io/badge/python-3.12-blue?logo=python&logoColor=white)
![License](https://img.shields.io/badge/license-MIT-green)
![Streamlit](https://img.shields.io/badge/Streamlit-1.45.1-FF4B4B)
![PyTorch](https://img.shields.io/badge/PyTorch-2.7.0-EE4C2C)
![Transformers](https://img.shields.io/badge/Transformers-4.52.4-yellow)

## Overview

A powerful PDF chatbot application that allows users to upload PDF documents and ask questions about their content. Built with Streamlit for the frontend and leveraging LLaMA-based models for natural language processing, this application provides an intuitive interface for document-based question answering.

## Features

📄 Upload and process PDF documents

💬 Chat interface for asking questions about document content

⚡ Fast response generation using LLaMA-based models

🧠 Context-aware answers based on document content

🎨 Clean, user-friendly interface

🔍 Sample PDF with demo questions included

## Installation

1. Clone the repository:

```bash
git clone https://github.com/Muzenda-K/PDF-Chatbot.git
cd pdf-chatbot
```

2. Create and activate a virtual environment (recommended):

```bash
python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`
```

3. Install the required dependencies:

```bash
pip install -r requirements.txt
```

## Usage

1. Run the Streamlit application:

```bash
streamlit run app.py
```

2. The application will open in your default browser at `http://localhost:8501`
3. Either use the provided sample PDF or upload your own document
4. Start asking questions about the document content

## Project demo

![Demo](demo.gif)

## Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

## License

Distributed under the MIT License.