---
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.