Repolode
GhostPeony

GhostPeony/clip-finder

Семантический поиск по транскриптам YouTube с самостоятельным хостингом: находите нужные фрагменты и переходите к точным таймкодам в каналах, плейлистах и видео.

Звёзды
55
Форки
6
Открытые issues
0
Последний коммит
4 месяца назад

Что это?

SearchTube индексирует транскрипты YouTube-канала, плейлиста или отдельного видео и позволяет искать по смыслу, а не только по точным ключевым словам. Каждый результат ведёт к подходящему таймкоду в видео — можно сразу перейти к нужному фрагменту.

Сервис работает в двух режимах. Для локального режима не нужен вход в аккаунт: векторы хранятся в локальной директории ChromaDB, а собственный ключ Gemini указывается в браузере. Режим Supabase добавляет аутентификацию пользователей, Postgres с pgvector, квоты на использование и ключи Gemini на сервере; также можно включить зашифрованное хранение ключей пользователей.

В стеке — фронтенд на React и бэкенд на FastAPI, для поиска используются эмбеддинги Gemini. В проект также входит скрипт оценки, который помогает сравнить модели эмбеддингов и их размерности перед изменением настроек по умолчанию.

Ключевые возможности

  • 01Семантический поиск по транскриптам YouTube со ссылками на таймкоды
  • 02Индексация каналов, плейлистов и отдельных видео
  • 03Пропускает уже проиндексированные видео
  • 04Локальный режим без авторизации или режим Supabase с входом для нескольких пользователей
  • 05Поддержка собственных ключей в браузере или их зашифрованное хранение на сервере
  • 06Скачивание транскриптов в формате SRT и история недавних поисковых запросов

Сценарии использования

  • Поиск нужного объяснения в длинном курсе лекций или на канале с обучающими видео
  • Поиск темы в плейлисте без необходимости просматривать каждое видео
  • Развёртывание закрытого сервиса поиска по транскриптам для команды или личного архива

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

  1. 1

    Клонируйте репозиторий

    git clone https://github.com/GhostPeony/SearchTube.git
  2. 2

    Создайте виртуальное окружение Python и установите зависимости backend

    python -m venv venv venv\Scripts\activate pip install -r requirements.txt
  3. 3

    Установите зависимости frontend, затем создайте файл .env.local и укажите в нём ключ Gemini API

    npm install
  4. 4

    Запустите backend в одном терминале, а frontend — в другом, затем откройте http://localhost:3001

    python backend/server.py npm run dev

Что важно знать

  • Для работы локального режима с эмбеддингами и поиском нужен ключ Gemini API.
  • В инструкциях по настройке используется команда активации venv для Windows; на других платформах нужна другая команда активации.
  • Транскрипты недоступны для видео без субтитров, а также для видео с региональными ограничениями или ограничениями по возрасту.

Темы

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

Что такое clip-finder?
Семантический поиск по транскриптам YouTube с самостоятельным хостингом: находите нужные фрагменты и переходите к точным таймкодам в каналах, плейлистах и видео. SearchTube индексирует транскрипты YouTube-канала, плейлиста или отдельного видео и позволяет искать по смыслу, а не только по точным ключевым словам. Каждый результат ведёт к подходящему таймкоду в видео — можно сразу перейти к нужному фрагменту.
clip-finder можно использовать бесплатно? Какая у него лицензия?
clip-finder распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
clip-finder всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в clip-finder — 2 июл. 2026 г..
Для чего можно использовать clip-finder?
Поиск нужного объяснения в длинном курсе лекций или на канале с обучающими видео Поиск темы в плейлисте без необходимости просматривать каждое видео Развёртывание закрытого сервиса поиска по транскриптам для команды или личного архива
Как установить clip-finder?
Клонируйте репозиторий: git clone https://github.com/GhostPeony/SearchTube.git Создайте виртуальное окружение Python и установите зависимости backend: python -m venv venv venv\Scripts\activate pip install -r requirements.txt Установите зависимости frontend, затем создайте файл .env.local и укажите в нём ключ Gemini API: npm install Запустите backend в одном терминале, а frontend — в другом, затем откройте http://localhost:3001: python backend/server.py npm run dev
Где скачать clip-finder?
Исходный код и инструкции по установке — на GitHub: https://github.com/GhostPeony/clip-finder

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

ИИ-инструмент, который превращает темы английской грамматики и словоупотребления в 30-секундные обучающие видео вертикального формата с китайскими субтитрами и выделенными английскими ключевыми словами.

18221PythonБез лицензииОбновлён 2 месяца назад