Spaces:
Runtime error
Runtime error
| title: Video Intelligence Chat | |
| emoji: 🎬 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: gradio | |
| sdk_version: "4.44.1" | |
| python_version: "3.10" | |
| app_file: app.py | |
| pinned: false | |
| # Video Intelligence Chat | |
| Chat with an AI about any video you upload. The app extracts frames, transcribes speech, and analyzes content using free-tier APIs — all running on Hugging Face Spaces CPU Basic hardware. | |
| --- | |
| ## One-Click Deploy to Hugging Face Spaces | |
| 1. Go to [huggingface.co/new-space](https://huggingface.co/new-space) | |
| 2. Set **SDK** to `Gradio` and **Hardware** to `CPU Basic` (free) | |
| 3. Clone your new Space and copy all project files in: | |
| ```bash | |
| git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME | |
| cd YOUR_SPACE_NAME | |
| cp -r /path/to/video-intelligence-chat/* . | |
| git add . | |
| git commit -m "Initial deploy" | |
| git push | |
| ``` | |
| 4. Add your secret: | |
| - Go to **Space Settings → Variables and Secrets** | |
| - Click **New Secret**: `NVIDIA_API_KEY` = `<your key>` | |
| The Space rebuilds automatically and is live in ~2 minutes. | |
| --- | |
| ## Getting a Free NVIDIA API Key | |
| 1. Sign up at [build.nvidia.com](https://build.nvidia.com) (free account) | |
| 2. Navigate to any model page and click **Get API Key** | |
| 3. Your free account includes ~1,000 API credits | |
| --- | |
| ## Required Secret | |
| | Secret name | Description | | |
| |---|---| | |
| | `NVIDIA_API_KEY` | From [build.nvidia.com](https://build.nvidia.com) | | |
| --- | |
| ## Hardware | |
| - **CPU Basic** (free tier) is sufficient | |
| - 16 GB RAM, 2 vCPU | |
| - `faster-whisper` runs locally on Space CPU — no GPU needed | |
| --- | |
| ## Optional Environment Variables | |
| | Variable | Default | Description | | |
| |---|---|---| | |
| | `FRAME_INTERVAL` | `5` | Seconds between extracted frames | | |
| | `WHISPER_MODEL` | `base` | Whisper model size: `tiny`, `base`, `small` | | |
| | `MAX_VIDEO_DURATION` | `600` | Warn if video exceeds this many seconds | | |
| --- | |
| ## Recommended Usage | |
| - **Video length:** Under 5 minutes on the free NVIDIA tier (to conserve API credits) | |
| - **Supported formats:** MP4, MOV, AVI, WebM | |
| - **Max upload size:** ~100 MB (Gradio default) | |
| --- | |
| ## Free Tier Limits | |
| | Service | Free Allowance | | |
| |---|---| | |
| | NVIDIA NIM | ~1,000 API credits on signup | | |
| | Hugging Face Spaces | Unlimited CPU Basic spaces | | |
| | faster-whisper (local) | No limits — runs on Space hardware | | |
| | HF Space RAM | 16 GB RAM, 2 vCPU | | |
| --- | |
| ## Tech Stack | |
| | Layer | Tool | | |
| |---|---| | |
| | Frontend / Backend | Gradio (Python) | | |
| | Hosting | Hugging Face Spaces | | |
| | Vision AI | NVIDIA NIM — `meta/llama-3.2-11b-vision-instruct` | | |
| | Chat LLM | NVIDIA NIM — `meta/llama-3.1-8b-instruct` | | |
| | Speech-to-text | faster-whisper (CPU, runs locally) | | |
| | Video processing | ffmpeg + OpenCV | | |