Add professional installation and usage guide to README

README.md

@@ -10,3 +10,64 @@ v1.0 • Apache 2.0 • Production
 
 </div>
 
+---
+
+## Installation
+
+### Prerequisites
+
+- **Burp Suite** (Pro or Community Edition)
+- **Python 2.7+** (Jython runtime, included with Burp)
+- **API Key** from [DigitalOcean AI](https://cloud.digitalocean.com) or compatible provider
+- **Java 8+** (bundled with Burp Suite)
+
+### Setup Steps
+
+1. **Download Extension**
+   ```bash
+   git clone https://github.com/Stalin-143/BURP-AI.git
+   cd BURP-AI
+   ```
+
+2. **Load in Burp Suite**
+   - Open Burp Suite
+   - Go to **Extensions** → **Installed** → **Add**
+   - Select `burpaai.py`
+   - Confirm and wait for initialization
+
+3. **Configure API Key**
+   - Click **BurpAI** tab in main window
+   - Enter your DigitalOcean API key
+   - Click **Save**
+   - Status should show "Connected"
+
+4. **Verify Installation**
+   - Select any HTTP request
+   - Right-click → **Send to BurpAI** (or click **Analyze with AI**)
+   - AI response appears in chat panel
+
+---
+
+## Quick Usage
+
+| Action | Method |
+|--------|--------|
+| **Analyze Request** | Select request → Click "Analyze with AI" |
+| **Send to AI** | Right-click request → "Send to BurpAI" |
+| **Chat With AI** | Type in input → Press ENTER or click Send |
+| **Switch Model** | Select from Model dropdown → Auto-updates |
+| **View History** | Click request in history table |
+
+---
+
+## Documentation
+
+- [Security Policy](SECURITY.md)
+- [Security Advisory](SECURITY_ADVISORY.md)
+- [Contributing](COLLABORATION.md)
+- [License](LICENSE)
+
+---
+
+**Status:** Production Ready | **For authorized security testing only**
+