README.md

---
title: SceneX Backend
emoji: 🔍
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# SceneX Crime Scene Analysis Backend

FastAPI backend for the SceneX mobile app. Runs DETR object detection, ViT classification, CLIP, YOLO, VideoMAE, and Gemini-powered report generation.

## Required Secrets

Set these in **Space settings → Variables and secrets**:

| Name | Description |
|------|-------------|
| `MONGO_URI` | MongoDB connection string |
| `SECRET_KEY` | JWT signing key |
| `ALGORITHM` | `HS256` |
| `GEMINI_API_KEY` | Google Gemini API key |
| `MAIL_USERNAME` | SMTP user (Gmail address) |
| `MAIL_PASSWORD` | SMTP app password |
| `MAIL_FROM` | Sender email |
| `MAIL_PORT` | `587` |
| `MAIL_SERVER` | `smtp.gmail.com` |
| `MAIL_STARTTLS` | `True` |
| `MAIL_SSL_TLS` | `False` |
| `USE_CREDENTIALS` | `True` |
| `VALIDATE_CERTS` | `True` |

## Endpoints

- `POST /signup`, `POST /login`, `POST /login/verify-otp`
- `POST /analyze`, `POST /download_report`, `POST /classify`, `POST /video_classify`
- `GET /history/{user_id}`, `POST /history`, `DELETE /history/{item_id}`