AmirAziz1221's picture
Update README.md
2175406 verified
---
title: AI Video Analysis System
emoji: 🎬
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.12.0
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.