d-e-e-k-11 commited on
Commit
9cf52c7
·
verified ·
1 Parent(s): 917122f

Add README.md

Browse files
Files changed (1) hide show
  1. README.md +40 -12
README.md CHANGED
@@ -1,12 +1,40 @@
1
- ---
2
- title: Chatbot
3
- emoji:
4
- colorFrom: purple
5
- colorTo: blue
6
- sdk: gradio
7
- sdk_version: 6.6.0
8
- app_file: app.py
9
- pinned: false
10
- ---
11
-
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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)