Update README.md

README.md

@@ -10,3 +10,23 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# Solar Fault Detector
+
+This Hugging Face Space detects faults in solar panels (cracks, dust, shade, etc.) from drone videos using a YOLOv8 model.
+
+## How it works
+- Upload a drone-shot video of solar panels
+- The app uses a YOLOv8 model (`best.pt`) to detect faults
+- Output video shows bounding boxes for detected faults
+
+## Model
+Trained on a custom best.pt with 4 classes: cracked, dusty, shaded, overheated.
+
+## Requirements
+All dependencies are listed in `requirements.txt`.
+
+## Demo
+Try uploading a video and view the output with annotated faults.
+
+