Upload README.md with huggingface_hub

README.md

@@ -1,16 +1,44 @@
+---
+title: "Death Legion Fraud Detection"
+emoji: "🔥"
+colorFrom: "red"
+colorTo: "red"
+sdk: "gradio"
+sdk_version: "4.19.0"
+python_version: "3.10"
+app_file: "app.py"
+pinned: false
+---
+
 # 🔥 Death Legion Fraud Detection System
 
 <p align="center">
-  <img src="https://img.shields.io/badge/Death%20Legion-Powered-red?style=for-the-badge&logo=skull" alt="Death Legion">
-  <img src="https://img.shields.io/badge/Best%20Teams-Elite-gold?style=for-the-badge&logo=crown" alt="Best Teams">
-  <img src="https://img.shields.io/badge/AUPRC-0.8177-success?style=for-the-badge" alt="AUPRC">
-  <img src="https://img.shields.io/badge/Model%20Size-6.12MB-blue?style=for-the-badge" alt="Size">
+<img src="https://img.shields.io/badge/Death%20Legion-Powered-red?style=for-the-badge&logo=skull" alt="Death Legion">
+<img src="https://img.shields.io/badge/Best%20Teams-Elite-gold?style=for-the-badge&logo=crown" alt="Best Teams">
+<img src="https://img.shields.io/badge/AUPRC-0.8177-success?style=for-the-badge" alt="AUPRC">
+<img src="https://img.shields.io/badge/Model%20Size-6.12MB-blue?style=for-the-badge" alt="Size">
 </p>
 
 ## 🎯 Overview
 
 Welcome to the **Death Legion Fraud Detection System** - a state-of-the-art machine learning solution for real-time credit card fraud detection. Built by the **Best Teams** with cutting-edge Random Forest technology, this model achieves exceptional performance on highly imbalanced financial datasets.
 
+## 🚀 Deploy This Space
+
+<p align="center">
+<a href="https://huggingface.co/spaces/Pnny13/fraud-detection-space?duplicate=true">
+<img src="https://img.shields.io/badge/🚀%20Deploy%20to%20HF-Spaces-blue?style=for-the-badge" alt="Deploy to Hugging Face">
+</a>
+</p>
+
+## 🎮 Use This Model
+
+<p align="center">
+<a href="https://huggingface.co/Pnny13/fraud-detection-model">
+<img src="https://img.shields.io/badge/🤗%20Use%20This%20Model-Hugging%20Face-yellow?style=for-the-badge" alt="Use This Model">
+</a>
+</p>
+
 ## ⚡ Key Features
 
 - **🛡️ Advanced Random Forest Architecture**: 500 estimators with optimized depth
@@ -39,52 +67,50 @@ Random Forest Classifier
 └── Format: Safetensors (6.12 MB)
 ```
 
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-pip install safetensors numpy pandas scikit-learn
-```
+## 📖 How to Use
 
-### Loading the Model
+### Quick Start
 
-```python
-from safetensors.numpy import load_file
-import numpy as np
+1. **Access the Live Demo**: Visit [https://huggingface.co/spaces/Pnny13/fraud-detection-space](https://huggingface.co/spaces/Pnny13/fraud-detection-space)
 
-# Load model
-tensors = load_file("fraud_detector.safetensors")
+2. **Enter Transaction Features**: Input the 30 features (V1-V28, Time, Amount) from your credit card transaction
 
-# Access metadata
-n_estimators = int(tensors['metadata/n_estimators'][0])
-print(f"Loaded model with {n_estimators} trees")
-```
+3. **Get Instant Prediction**: The system will return:
+   - Fraud probability score (0-100%)
+   - Binary classification (Fraud/Legitimate)
+   - Recommendation for action
 
-### Making Predictions
+### Programmatic Usage
 
 ```python
-# Your transaction features (30 features: V1-V28, Time, Amount)
-features = np.array([[...]])  # Shape: (1, 30)
-
-# Load and predict using the inference script
-from inference import load_artifacts_safetensors, predict
+from safetensors.numpy import load_file
+import numpy as np
 
-model, scaler = load_artifacts_safetensors()
-predictions, probabilities = predict(model, scaler, features)
+# Load model from Hugging Face Hub
+from huggingface_hub import hf_hub_download
+model_path = hf_hub_download(
+    repo_id="Pnny13/fraud-detection-model",
+    filename="fraud_detector.safetensors"
+)
 
-print(f"Fraud Probability: {probabilities[0]:.4f}")
-print(f"Prediction: {'FRAUD' if predictions[0] == 1 else 'LEGITIMATE'}")
+# Load and predict
+tensors = load_file(model_path)
+# ... use model for predictions
 ```
 
 ## 📁 Repository Structure
 
 ```
+Pnny13/fraud-detection-space/
+├── app.py              # Gradio application
+├── requirements.txt    # Python dependencies
+└── README.md           # Documentation
+
 Pnny13/fraud-detection-model/
-├── fraud_detector.safetensors    # Trained model (6.12 MB)
-├── scaler.joblib                  # Feature scaler
-├── inference.py                   # Prediction script
-└── README.md                      # This file
+├── fraud_detector.safetensors  # Trained model
+├── scaler.joblib               # Feature scaler
+├── inference.py                # Prediction script
+└── README.md                   # Model documentation
 ```
 
 ## 🔬 Technical Details
@@ -118,13 +144,13 @@ Try the live interactive demo at: **https://huggingface.co/spaces/Pnny13/fraud-d
 ## 🤝 Credits
 
 <p align="center">
-  <strong>Powered by Death Legion</strong><br>
-  <em>Elite Machine Learning Division</em>
+<strong>Powered by Death Legion</strong><br>
+<em>Elite Machine Learning Division</em>
 </p>
 
 <p align="center">
-  <strong>Best Teams Collaboration</strong><br>
-  <em>Excellence in AI Engineering</em>
+<strong>Best Teams Collaboration</strong><br>
+<em>Excellence in AI Engineering</em>
 </p>
 
 ## 📜 License
@@ -137,8 +163,6 @@ This model is released under the MIT License. Use responsibly for fraud detectio
 - 🚀 Space: https://huggingface.co/spaces/Pnny13/fraud-detection-space
 - 📊 Dataset: https://www.kaggle.com/datasets/mlg-ulb/creditcardfraud
 
----
-
 <p align="center">
-  <sub>Built with 🔥 by Death Legion | Best Teams Elite Division</sub>
-</p>
+<sub>Built with 🔥 by Death Legion | Best Teams Elite Division</sub>
+</p>