Update README.md

README.md

@@ -32,24 +32,122 @@ A ChatGPT-like interface built with Gradio that supports file uploads and uses a
 - **🛡️ Error Handling**: Graceful fallback to smaller models if the main model fails
 - **📱 Responsive Design**: Clean, user-friendly interface
 
-## 🚀 Quick Start
+## 🚀 How to Run the Chatbot
 
-### Option 1: Easy Start (Windows)
+### ⚠️ **IMPORTANT: Virtual Environment Required**
 
-Double-click the `start_chatbot.bat` file
+This project uses a virtual environment with all dependencies installed. Follow the **exact sequence** below to run the chatbot successfully.
 
-### Option 2: From Terminal
+### **✅ Recommended Method (Step-by-Step)**
+
+1. **Open Terminal** in the project folder:
+
+   ```bash
+   cd "C:\Users\Cosmo\Desktop\GPT\GPT"
+   ```
+
+2. **Activate Virtual Environment**:
+
+   ```bash
+   .\env\Scripts\activate.bat
+   ```
+
+3. **Run with Full Python Path** (this ensures it works even if activation doesn't fully work):
+
+   ```bash
+   C:/Users/Cosmo/Desktop/GPT/GPT/env/Scripts/python.exe app.py
+   ```
+
+4. **Success! You should see**:
+
+   ```
+   * Running on local URL:  http://127.0.0.1:7860
+   ```
+
+5. **Open your browser** and go to: **http://127.0.0.1:7860**
+
+### **Alternative Methods**
+
+### **Method 1: Using the Batch File (if available)**
+
+1. **Double-click** the `start_chatbot.bat` file in the project folder
+2. This should automatically handle everything
+
+### **Method 2: PowerShell (if execution policy allows)**
+
+1. **Open PowerShell** in the project folder
+2. **Fix execution policy** (one-time setup):
+   ```powershell
+   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+   ```
+3. **Activate and run**:
+   ```powershell
+   .\env\Scripts\Activate.ps1
+   python app.py
+   ```
+
+### **Method 3: From VS Code**
+
+1. **Open the project folder** in VS Code
+2. **Open integrated terminal** (Ctrl + `)
+3. **Use the recommended sequence**:
+   ```bash
+   .\env\Scripts\activate.bat
+   C:/Users/Cosmo/Desktop/GPT/GPT/env/Scripts/python.exe app.py
+   ```
+
+### **✅ Verify Virtual Environment is Active**
+
+When the virtual environment is active, you should see `(env)` at the beginning of your command prompt:
+
+```
+(env) C:\Users\Cosmo\Desktop\GPT\GPT>
+```
+
+**⚠️ Important**: Even with `(env)` showing, you may still need to use the full Python path for the app to work correctly.
+
+### **❌ Common Errors & Solutions**
+
+#### **Error: "ModuleNotFoundError: No module named 'gradio'"**
+
+**Even if you see `(env)` in your prompt**, this error means the Python path isn't correct.
+
+**✅ Solution**: Always use the full Python path:
 
 ```bash
-python app.py
+C:/Users/Cosmo/Desktop/GPT/GPT/env/Scripts/python.exe app.py
 ```
 
-### Option 3: From VS Code
+#### **Error: ".\env\Scripts\Activate.ps1 cannot be loaded"**
+
+This is a PowerShell execution policy issue.
 
-Open the integrated terminal and run:
+**✅ Solutions** (choose one):
+
+1. **Use Command Prompt activation instead**:
+
+   ```bash
+   .\env\Scripts\activate.bat
+   ```
+
+2. **Fix PowerShell execution policy**:
+
+   ```powershell
+   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+   ```
+
+3. **Use the batch file**: Double-click `start_chatbot.bat`
+
+#### **Error: Missing packages**
+
+If packages aren't installed in the virtual environment:
 
 ```bash
-python app.py
+# Activate first
+.\env\Scripts\activate.bat
+
+# Then install
+pip install -r requirements.txt
 ```
 
 ## 🌐 Using the Chatbot