| --- |
| title: Lead Hunter AI |
| emoji: 🎯 |
| colorFrom: blue |
| colorTo: indigo |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| --- |
| |
| # Lead Hunter AI Dashboard |
|
|
| A powerful, futuristic Lead Generation Engine built with FastAPI and React. |
|
|
| ## 🚀 Deployment Instructions for Hugging Face Spaces |
|
|
| 1. Create a **New Space** on Hugging Face. |
| 2. Select **Docker** as the SDK. |
| 3. Choose the **Blank** template (or any Docker template). |
| 4. Upload all files from this repository (including `Dockerfile`, `app.py`, `frontend/`, `tools/`, and `requirements.txt`). |
| 5. Hugging Face will automatically build and start the Space on port 7860. |
|
|
| ## 📁 Project Structure |
|
|
| - `app.py`: FastAPI Backend (API + Static File Server) |
| - `frontend/`: React + Vite + GSAP Dashboard |
| - `tools/`: Playwright Scraper and Enrichment Agents |
| - `Dockerfile`: Multi-stage build for Node/Python/Playwright environment |
|
|
| ## 🛡️ Robustness Features |
| - Pre-configured Playwright dependencies. |
| - Static file serving integrated into the backend. |
| - Relative API paths for cross-domain stability. |
|
|
