Files

NANDI 1560ecadd6 Add README with setup and usage instructions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-05 10:37:56 +01:00

2.3 KiB

Raw Permalink Blame History

Twitch Stream Vision Analyzer

Программа в реальном времени анализирует Twitch-стрим: периодически захватывает кадры и отправляет их в Gemini Vision API, получая текстовое описание происходящего.

Twitch HLS → streamlink → ffmpeg (кадр каждые N сек) → Gemini Vision API → консоль + лог

Требования

Python 3.10+
ffmpeg (установлен в системе)
API ключ Google AI Studio

Установка

git clone https://git.animeenigma.ru/NANDI/twitchStreamVision.git
cd twitchStreamVision
pip install -r requirements.txt

Настройка

Скопируй .env.example в .env и укажи API ключ:

cp .env.example .env

GEMINI_API_KEY=your-api-key-here
# Опционально: Cloudflare AI Gateway
# GEMINI_BASE_URL=https://gateway.ai.cloudflare.com/v1/account/gateway/google-ai-studio

Запуск

python3 main.py --channel xqc --interval 15 --quality 480p

Аргументы

Аргумент	По умолчанию	Описание
`--channel`	(обязательный)	Имя Twitch-канала
`--interval`	`15`	Интервал захвата кадров (секунды)
`--quality`	`480p`	Качество стрима (`480p`, `720p`, `1080p`, `best`)
`--lang`	`ru`	Язык описаний (`ru` / `en`)
`--log-file`	`stream_log.txt`	Путь к лог-файлу

Как это работает

streamlink подключается к Twitch-каналу и получает HLS-поток
ffmpeg извлекает JPEG-кадры с заданным интервалом (без записи на диск)
Gemini Vision API анализирует каждый кадр и возвращает краткое описание
Результат выводится в консоль (через rich) и записывается в лог-файл

Для связности описаний контекст предыдущего ответа передаётся в следующий запрос.

Остановка — Ctrl+C.

2.3 KiB Raw Permalink Blame History Unescape Escape