Update README.md

README.md

@@ -14,10 +14,12 @@ pinned: false
 [![Python 3.10](https://img.shields.io/badge/Python-3.10-blue.svg)](https://python.org)
 [![Flask](https://img.shields.io/badge/Flask-3.0-green.svg)](https://flask.palletsprojects.com)
 [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Hugging Face](https://img.shields.io/badge/🤗-Hugging%20Face-ff9f0e)](https://huggingface.co/spaces)
+[![Hugging Face](https://img.shields.io/badge/🤗-Hugging%20Face-ff9f0e)](https://huggingface.co/spaces/Lawino/lost_found)
 
 > **AI-Powered Campus Lost & Found System** — Reunite lost items with their owners using intelligent matching, image recognition, and a modern web interface.
 
+**Live Demo:** [https://huggingface.co/spaces/Lawino/lost_found](https://huggingface.co/spaces/Lawino/lost_found)
+
 ---
 
 ## 📋 Table of Contents
@@ -26,16 +28,11 @@ pinned: false
 - [Features](#-features)
 - [Tech Stack](#-tech-stack)
 - [Quick Start](#-quick-start)
-  - [Hugging Face Spaces Deployment](#hugging-face-spaces-deployment)
-  - [Docker Deployment](#docker-deployment-recommended)
-  - [Local Development](#local-development)
 - [Configuration](#-configuration)
 - [Admin Panel](#-admin-panel)
-- [API Endpoints](#-api-endpoints)
 - [Environment Variables](#-environment-variables)
 - [Troubleshooting](#-troubleshooting)
-- [Contributing](#-contributing)
-- [License](#-license)
+- [API Endpoints](#-api-endpoints)
 
 ---
 
@@ -68,24 +65,18 @@ pinned: false
 - **AI Chatbot** — Conversational assistant for guided reporting
 
 ### 🤖 AI Capabilities
-- **Intent Detection** — Understands user queries (report lost, search, claim, etc.)
+- **Intent Detection** — Understands user queries
 - **Item Categorization** — Auto-tags items into 7+ categories
 - **Color Detection** — Extracts dominant colors from images
-- **Match Scoring** — Multi-factor similarity algorithm (category, location, color, brand, date)
-- **OpenRouter Integration** — Supports multiple LLM models (Gemini, Llama, Phi)
+- **Match Scoring** — Multi-factor similarity algorithm
+- **OpenRouter Integration** — Supports multiple LLM models
 
 ### 🔧 Admin Features
-- **Admin Panel** — Full CRUD operations on users, items, claims
-- **Analytics Dashboard** — Charts for daily activity and item distribution
-- **User Management** — Ban/unban, delete users with one click
-- **Claim Review** — Approve/reject claims with admin notes
+- **Admin Panel** — Full CRUD operations at `/nimda`
+- **Analytics Dashboard** — Charts for daily activity
+- **User Management** — Ban/unban, delete users
+- **Claim Review** — Approve/reject with admin notes
 - **Export Data** — CSV exports for users and items
-- **Manual Matching** — Trigger matching engine on demand
-
-### 📱 Responsive Design
-- Dark/Light theme toggle
-- Mobile-first layout
-- Works on desktop, tablet, and smartphone
 
 ---
 
@@ -105,17 +96,45 @@ pinned: false
 
 ## 🚀 Quick Start
 
-### Hugging Face Spaces Deployment (Easiest)
+### Access the Live Application
+
+Your application is live at: **https://huggingface.co/spaces/Lawino/lost_found**
+
+### Configure Secrets (Required)
+
+Go to your Space Settings → **Repository Secrets** and add:
+
+| Secret Name | Required | Example Value |
+|-------------|----------|---------------|
+| `FLASK_SECRET_KEY` | **Yes** | `your_random_32_char_secret_key` |
+| `OPENROUTER_API_KEY` | No | `sk-or-v1-xxxxx` (for AI features) |
+| `ADMIN_USERNAME` | No | `admin` |
+| `ADMIN_PASSWORD` | No | `ChangeMe123!` |
+| `ADMIN_EMAIL` | No | `admin@campus.edu` |
+
+### Default Admin Credentials (if not set)
+- Username: `admin`
+- Password: `admin123`
+
+**⚠️ IMPORTANT:** Change these credentials immediately after first login!
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://huggingface.co/spaces/Lawino/lost_found
+cd lost_found
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
 
-1. **Create a new Space** on [Hugging Face Spaces](https://huggingface.co/new-space)
-   - Choose **Docker** as the SDK
-   - Select **Blank** template
-   - Set Space name (e.g., `campus-recovery-network`)
+# Set environment variables
+export FLASK_SECRET_KEY="your-secret-key-here"
+export OPENROUTER_API_KEY="your-api-key"  # Optional
 
-2. **Configure Secrets** in Space Settings → Repository Secrets:
-   ```bash
-   OPENROUTER_API_KEY=sk-or-v1-your-key-here
-   ADMIN_USERNAME=admin
-   ADMIN_PASSWORD=change_this_secure_password
-   ADMIN_EMAIL=admin@campus.edu
-   FLASK_SECRET_KEY=your_random_secret_key_32_chars_min
+# Run the application
+python app.py