Spaces:
Runtime error
Runtime error
Add README.md
Browse files
README.md
CHANGED
|
@@ -1,12 +1,40 @@
|
|
| 1 |
-
--
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Llama-2-7B Desktop Chatbot
|
| 2 |
+
|
| 3 |
+
A modern, high-performance desktop chatbot built with Python, using **Tkinter (CustomTkinter)** and **Llama-2-7B (GGMLv3)**.
|
| 4 |
+
|
| 5 |
+
## ✨ Features
|
| 6 |
+
- **Offline AI**: No internet connection required after model download.
|
| 7 |
+
- **Premium UI**: Sleek dark/light modes with a professional sidebar layout.
|
| 8 |
+
- **Real-time Status**: Indicators for Loading, Online, and Thinking states.
|
| 9 |
+
- **Efficient**: Uses `llama-cpp-python` for fast CPU inference on consumer hardware.
|
| 10 |
+
|
| 11 |
+
## 🛠️ Setup Instructions
|
| 12 |
+
|
| 13 |
+
### 1. Requirements
|
| 14 |
+
Ensure you have Python 3.8+ installed.
|
| 15 |
+
|
| 16 |
+
### 2. Install Dependencies
|
| 17 |
+
```bash
|
| 18 |
+
pip install -r requirements.txt
|
| 19 |
+
```
|
| 20 |
+
*Note: This project specifically uses `llama-cpp-python==0.1.77` to maintain compatibility with GGMLv3 models.*
|
| 21 |
+
|
| 22 |
+
### 3. Download the Model
|
| 23 |
+
Download the `llama-2-7b-chat.ggmlv3.q2_K.bin` model (approximately 2.8GB) from a trusted source like Hugging Face.
|
| 24 |
+
|
| 25 |
+
### 4. Configure Model Path
|
| 26 |
+
Open `app.py` and update the `MODEL_PATH` variable on line 223 with the absolute path to your downloaded model file:
|
| 27 |
+
```python
|
| 28 |
+
MODEL_PATH = r"C:\path\to\your\llama-2-7b-chat.ggmlv3.q2_K.bin"
|
| 29 |
+
```
|
| 30 |
+
|
| 31 |
+
### 5. Run the App
|
| 32 |
+
```bash
|
| 33 |
+
python app.py
|
| 34 |
+
```
|
| 35 |
+
|
| 36 |
+
## 🖥️ Preview
|
| 37 |
+
The app includes a sidebar for theme switching, a "New Chat" button, and a scrollable chat interface with colorful sender labels.
|
| 38 |
+
|
| 39 |
+
---
|
| 40 |
+
Created by [deeksha133](https://github.com/deeksha133)
|