README_HF.md

SafeSpace AI API

AI-powered threat detection and safety analysis 🛡️

This FastAPI application provides intelligent threat detection and sentiment analysis capabilities using machine learning models.

🚀 Features

• Threat Detection: AI-powered analysis of potential threats
• Sentiment Analysis: Emotional tone detection in text
• Location-based Analysis: Geographic threat assessment
• Real-time Processing: Fast API responses for real-time applications

🤖 ML Models

• Threat.pkl: Binary classification for threat detection
• sentiment.pkl: Sentiment and emotion analysis
• contextClassifier.onnx: Context understanding model

📡 API Endpoints

• GET /: API status and information
• GET /health: Health check endpoint
• POST /api/threats/analyze: Analyze text for threats
• GET /api/models/status: Check model loading status
• GET /docs: Interactive API documentation

🔧 Usage

Analyze Threat

import requests

response = requests.post(
    "https://your-space-name-username.hf.space/api/threats/analyze",
    json={
        "title": "Suspicious Activity",
        "description": "There's something concerning happening",
        "location": "New York, NY"
    }
)

result = response.json()
print(f"Threat Level: {result['threat_level']}")
print(f"Confidence: {result['final_confidence']}")

🛠️ Development

Built with:

• FastAPI - Modern, fast web framework
• scikit-learn - Machine learning models
• ONNX Runtime - Optimized inference
• Uvicorn - ASGI server

📝 License

This project is part of the SafeSpace application for enhanced public safety through AI.

---

Deployed on Hugging Face Spaces 🤗