Update README.md

README.md

@@ -9,4 +9,31 @@ python_version: 3.11
 app_file: app.py
 pinned: false
 license: mit
----
+---
+
+# 🎬 Agentic AI Video Analysis System — Gradio Edition
+
+An end-to-end video analysis pipeline powered by YOLOv8, Groq LLaMA-3, and Gradio for Hugging Face Spaces.
+
+## What it does
+- Extracts frames from an uploaded video using OpenCV
+- Detects objects in each frame using YOLOv8 nano
+- Generates a natural-language summary using Groq LLaMA-3 or mock mode
+- Produces an analysis report with insights, risk flags, and recommendations
+- Lets users download JSON and text reports
+
+## How to use
+1. Upload a video in MP4, AVI, MOV, or MKV format
+2. Adjust frame extraction and detection settings
+3. Click Analyze Video
+4. Review extracted frames, annotated frames, summaries, and reports
+
+## API Key Setup
+1. Get a Groq API key
+2. Open Space Settings → Secrets
+3. Add:
+   - Name: GROQ_API_KEY
+   - Value: your key
+4. Restart the Space
+
+Without a key, the app still works in mock mode.