🎬 Видео RAG на базе MCP

Задавайте вопросы на естественном языке о ваших видео — на базе Whisper + ChromaDB + Groq + FastMCP. Полностью бесплатно и работает локально.

Архитектура и как это работает

Your Video → Whisper (transcription) → ChromaDB (vector store)
                                              ↓
                              Antigravity IDE ← MCP Server ← Your Question
                                              ↓
                                         Groq LLM (free) → Answer + Timestamps

Стек (все бесплатно)

⚡ Быстрый старт

1. Установите зависимости

uv sync

2. Получите бесплатный API-ключ Groq

Перейдите на https://console.groq.com/ → создайте аккаунт → скопируйте API-ключ.

3. Настройте окружение

copy .env.example .env
# Edit .env and paste your GROQ_API_KEY

4. Добавьте MCP-сервер в Antigravity IDE

Скопируйте содержимое mcp_config.json в настройки MCP вашей Antigravity IDE. Обновите GROQ_API_KEY на ваш реальный ключ.

5. Поместите видео в папку videos/

Поддерживаются: .mp4, .mkv, .avi, .mov, .webm, .mp3, .wav

🛠️ Доступные MCP-инструменты

📖 Пример использования (в Antigravity IDE)

ingest_video("videos/my_lecture.mp4")

ask_video("What are the main topics discussed?")

search_video("neural networks explained", n_results=3)

ask_video("What did the speaker say about backpropagation?", video_name="my_lecture.mp4")

⚙️ Конфигурация (.env)

GROQ_API_KEY=your_key_here        # Required — get free at console.groq.com
WHISPER_MODEL=base                # tiny | base | small | medium | large
EMBEDDING_MODEL=all-MiniLM-L6-v2  # local embedding model
GROQ_MODEL=llama-3.1-8b-instant  # Groq model for Q&A
CHROMA_DB_PATH=./chroma_db        # where to persist the vector DB

💡 Советы

• Используйте WHISPER_MODEL=tiny для самой быстрой транскрибации (менее точной)

• Используйте WHISPER_MODEL=medium для высокой точности (медленнее)

• При первом запуске загружаются модели Whisper и эмбеддингов (~200MB каждая) — последующие запуски мгновенные

• Данные ChromaDB сохраняются между перезапусками в ./chroma_db/