63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
|
# Twitch Stream Vision Analyzer
|
|||
|
|
|
|||
|
|
Программа в реальном времени анализирует Twitch-стрим: периодически захватывает кадры и отправляет их в Gemini Vision API, получая текстовое описание происходящего.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Twitch HLS → streamlink → ffmpeg (кадр каждые N сек) → Gemini Vision API → консоль + лог
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Требования
|
|||
|
|
|
|||
|
|
- Python 3.10+
|
|||
|
|
- ffmpeg (установлен в системе)
|
|||
|
|
- API ключ [Google AI Studio](https://aistudio.google.com/apikey)
|
|||
|
|
|
|||
|
|
## Установка
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://git.animeenigma.ru/NANDI/twitchStreamVision.git
|
|||
|
|
cd twitchStreamVision
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Настройка
|
|||
|
|
|
|||
|
|
Скопируй `.env.example` в `.env` и укажи API ключ:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cp .env.example .env
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```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
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Запуск
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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` | Путь к лог-файлу |
|
|||
|
|
|
|||
|
|
## Как это работает
|
|||
|
|
|
|||
|
|
1. **streamlink** подключается к Twitch-каналу и получает HLS-поток
|
|||
|
|
2. **ffmpeg** извлекает JPEG-кадры с заданным интервалом (без записи на диск)
|
|||
|
|
3. **Gemini Vision API** анализирует каждый кадр и возвращает краткое описание
|
|||
|
|
4. Результат выводится в консоль (через rich) и записывается в лог-файл
|
|||
|
|
|
|||
|
|
Для связности описаний контекст предыдущего ответа передаётся в следующий запрос.
|
|||
|
|
|
|||
|
|
Остановка — `Ctrl+C`.
|