readme stuff

README.md

@@ -8,3 +8,17 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# Cloudzy AI Photo Intelligence Service
+
+A backend software solution for the **Cloudzy AI Challenge**. This service provides a scalable, local-first API for photo management, featuring automated AI analysis, semantic search, and demographic facial recognition.
+
+## 📋 Project Overview
+This project implements a cloud-based photo management service. The system is designed so that using AI for image analysis is mandatory. Unlike traditional keyword search, this system enables semantic search using vector embeddings.
+
+### Key Features
+* **📷 Photo Upload & Storage:** Async processing allows for immediate UI feedback while heavy AI tasks run in the background.
+* **🧠 Auto-Captioning:** Uses **BLIP** to generate descriptive sentences and tags for every photo.
+* **🔍 Semantic Search:** Uses **CLIP** embeddings stored in **ChromaDB** to rank photos by relevance to natural language queries.
+* **👤 Smart Feature (Face Analytics):** Uses **InsightFace** to detect faces, estimate age/gender, and auto-tag images.
+* **💻 Built-in UI:** A lightweight web interface to test uploading and searching without external tools.