README.md

---
title: AI Caption Generator
emoji: "🤖"
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 6.3.0
python_version: "3.10"
app_file: app.py
pinned: false
---

# AI Caption Generator

Public demo for generating captions from images and short videos.

## Secrets (recommended)

Set these in your Hugging Face Space **Settings → Secrets**:

- `OPENROUTER_API_KEY` (required) – the app enforces AI caption polishing.
- `BLIP_OFFLINE` (optional) – set to `1` only if you have a preloaded HF cache.

## Notes

- First run will download the BLIP model from Hugging Face.
- Video captioning uses OpenCV to sample frames.