VidXP — плагин

Локальный поиск по видео: реплики, звуки, сцены и действия находятся по смыслу, агенты получают кадры и клипы.

  • 59 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Расширенный доступ

Почему такой уровень

  • Индексирует видеозаписи, включая лица, на вашем компьютере и скачивает несколько гигабайт моделей; серверный режим открывает HTTP API.
Все причины и проверки

grayhatdevelopers/vidxp

Установка

Работает в

Ручная установка

Текст для агента

Add https://github.com/grayhatdevelopers/vidxp as a Git plugin marketplace, install the VidXP plugin, then use its $vidxp-install skill to set up VidXP on this computer.

Эту фразу вставляют в Codex; плагин подключает навык установки и два навыка работы с видео.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Индексирует видеозаписи, включая лица, на вашем компьютере и скачивает несколько гигабайт моделей; серверный режим открывает HTTP API.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

VidXP делает видео или целую коллекцию доступной для поиска по смыслу. Поиск по речи находит момент по пересказу фразы, поиск по сцене и действию принимает описание того, что видно на экране и происходит несколько секунд, поиск по звуку работает по событиям, а сопоставление лиц группирует повторяющихся людей внутри видео и экспортирует ролик с выделением. Агентам VidXP доступен как плагин Codex с тремя навыками (установка и подключение, загрузка и индексация, поиск моментов с доказательствами) и как MCP-сервер, по которому клиент добавляет видео, ищет по библиотеке и возвращает кадры, доски и клипы. Команда `vidxp mcp-config` печатает настройки для локального клиента. Есть настольное приложение, CLI, браузерный интерфейс, HTTP API и расширение для Premiere Pro.

Для кого. Монтажерам, архивистам и командам, которые хранят годы видеозаписей и хотят спрашивать агента, где что прозвучало или появилось.

Подходит, если

  • В семейном архиве нужно найти момент по фразе, которую помнишь неточно.
  • Редактору надо отобрать из часов материала сцены с заданным действием.
  • Агент отвечает на вопрос по видеобиблиотеке и возвращает кадры как доказательство.
  • Видео остается на своей машине, и облачные сервисы поиска не подходят.

Не подходит, если

  • Нужен однократный просмотр короткого ролика без индексации.
  • Компьютер без места под модели: поиск скачивает около 1–3 ГБ.
  • Лица людей нельзя обрабатывать даже локально.

Пример запроса к агенту

Найди в моих видео момент, где кто-то говорит про продление договора, и покажи кадры и клип с этим местом.

Ограничения

Поддерживаются Windows, macOS на Apple Silicon и Linux. Среда Python, которую настольное приложение ведет само, занимает около 3 ГиБ, а модели скачиваются по выбранным возможностям: речь 2,64 ГиБ, сцены 1,43 ГиБ, звук 0,94 ГиБ, действия 0,93 ГиБ, лица 37 МиБ. Для установки командой нужны `uv`, Python 3.14 и FFmpeg. Лица группируются внутри одного видео, личность по ним не определяется. Серверный режим и HTTP API настраиваются отдельно по руководству установки, а расширение для Premiere Pro ставится независимо от плагина Codex.

Как отключить. Удалите плагин VidXP из маркетплейса Codex, затем выполните `uv tool uninstall vidxp` и стерите каталог с индексом и скачанными моделями.

Частые вопросы

Как подключить VidXP к Codex?

Вставьте в Codex просьбу добавить репозиторий `grayhatdevelopers/vidxp` как Git-маркетплейс, поставить плагин и вызвать навык `vidxp-install`. Настольное приложение делает то же кнопкой «Set up in Codex».

Как поставить из командной строки?

Установите `uv`, затем выполните `uv tool install --python 3.14 --torch-backend cpu "vidxp[local-worker,mcp]"`, после чего `vidxp init`, `vidxp prepare` и `vidxp doctor`. Эти команды проверят FFmpeg и скачают модели.

Какие виды поиска есть?

По речи, по звуковым событиям, по сценам, по действиям и по повторяющимся лицам внутри видео.

Уходят ли видео в облако?

По умолчанию нет: видео остается на вашей машине. Облачные клиенты могут подключаться к развернутому серверу VidXP, если вы его запустили.

Как открыть браузерный интерфейс?

Поставьте пакет с дополнением `frontend` и выполните `vidxp ui`.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

MCP-сервер, плагин /video и CLI: расшифровка, ключевые кадры, текст с экрана и метаданные видео из YouTube, Loom, TikTok или файла

MCP-серверРасширенный доступ122Звезды репозитория

Reelpack разбирает локальное видео на расшифровку, склейки, текст на экране и ритм музыки, чтобы агент не смотрел ролик целиком.

СкиллРасширенный доступ200Звезды репозитория

CLI и скилл для Claude Code, Codex и Cursor: индекс видео, поиск по словам и тексту кадра, кадры крупно и замер монтажа

CLIРасширенный доступ76Звезды репозитория
Официальный

Агент в Cursor или Claude Desktop описывает видео, режет его на главы и кадры и ищет моменты по речи и картинке через Cloudglue

MCP-серверРасширенный доступ14Звезды репозитория

Claude Video Vision

claude-video-vision

MCP-сервер и плагин Claude Code, которые дают агенту смотреть видео: кадры через ffmpeg и расшифровка звука через Gemini, локальный Whisper или OpenAI

MCP-серверРасширенный доступ1,5 тыс.Звезды репозитория

Коротко о README

Проект подается как локальная поисковая система для людей и ИИ-агентов с настольным приложением, CLI, MCP и HTTP API. Нужное скачивается по возможностям, а перед загрузкой моделей показывается размер и место.

Бейдж для README

Сообщить о проблеме