Upload README.md with huggingface_hub

README.md

@@ -1,13 +1,116 @@
 ---
-title: Lead Ai Fraud Shield
-emoji: 🔥
-colorFrom: pink
-colorTo: blue
+title: Lead.AI Fraud Shield
+emoji: 🛡
+colorFrom: red
+colorTo: yellow
 sdk: gradio
-sdk_version: 6.14.0
-python_version: '3.13'
+sdk_version: "4.0.0"
 app_file: app.py
-pinned: false
+pinned: true
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🛡 Lead.AI Fraud Shield
+
+**Explainable AI Fraud Detection for Small Businesses**
+
+[![Website](https://img.shields.io/badge/Website-lead--ai.us-blue)](https://www.lead-ai.us)
+[![GitHub](https://img.shields.io/badge/GitHub-Lead--AI--US-black)](https://github.com/Lead-AI-US/lead-ai-fraud-shield)
+[![Gumroad](https://img.shields.io/badge/Buy-Starter%20Kit%20%2497-orange)](https://arunkg7.gumroad.com/l/ihsob)
+
+---
+
+## What This Does
+
+The Lead.AI Fraud Shield analyzes business transactions in real time,
+assigns a risk score (0–100%), and explains exactly why each alert was triggered —
+in plain English, not technical jargon.
+
+**No black boxes. Full explainability.**
+
+---
+
+## Business Use Case
+
+| Problem | Solution |
+|---|---|
+| Chargebacks and refund abuse | Risk score flags transactions before processing |
+| Manual fraud review | Automated scoring with instant explanations |
+| No audit trail | Every decision is logged with reasoning |
+| Fear of false positives | Adjustable thresholds, not binary yes/no |
+
+**Industries:** E-commerce, SaaS, financial services, marketplace platforms
+
+---
+
+## How to Use This Demo
+
+1. Enter transaction details (amount, hour, merchant type, etc.)
+2. Click **Analyze Transaction**
+3. Read the risk score and plain-English explanation
+4. Use the example presets to see high-risk vs. low-risk patterns
+
+---
+
+## What Your Custom System Includes
+
+When you deploy through Lead.AI, your Fraud Shield is:
+
+- Trained on **your real transaction history**
+- Calibrated to **your business's risk tolerance**
+- Connected to **your payment processor or CRM**
+- Monitored with **real-time alerts** to your phone or email
+- Explained with **full audit-ready documentation**
+
+---
+
+## Technical Stack
+
+| Layer | Technology |
+|---|---|
+| ML Model | Random Forest with SHAP explainability |
+| Interface | Gradio |
+| Deployment | Hugging Face Spaces |
+| Production | FastAPI + Docker |
+
+---
+
+## Buy the Starter Kit
+
+Get the full source code, sample dataset, and step-by-step setup guide:
+
+👉 **[Buy Lead.AI Fraud Detection Kit — $97](https://arunkg7.gumroad.com/l/ihsob)**
+
+Includes:
+- Complete Python source code
+- Sample transaction dataset (5,000 rows)
+- Setup guide (no ML experience needed)
+- Configuration templates
+- 30-day email support
+
+---
+
+## Get a Custom Deployment
+
+> ⚠️ This demo runs on synthetic data. For production use, your system must be trained and validated on your actual business data.
+
+**Need this customized for your business?**
+
+👉 **[Request a Custom Lead.AI Setup → www.lead-ai.us](https://www.lead-ai.us)**
+
+We handle:
+- Training on your real data
+- Integration with your systems
+- Deployment and monitoring
+- Ongoing support
+
+---
+
+## Links
+
+| Platform | Link |
+|---|---|
+| 🌐 Website | [www.lead-ai.us](https://www.lead-ai.us) |
+| 💻 Source Code | [GitHub](https://github.com/Lead-AI-US/lead-ai-fraud-shield) |
+| 🛒 Starter Kit | [Buy — $97](https://arunkg7.gumroad.com/l/ihsob) |
+| 📧 Contact | hello@lead-ai.us |