Skip to content

README.md

Latest commit

 

History

History
132 lines (95 loc) · 4.33 KB

README.md

File metadata and controls

132 lines (95 loc) · 4.33 KB
Raw

yuki

CLI-инструмент для создания Anki-карточек из YouTube видео или файлов субтитров.

Возможности

  • Извлечение словаря из YouTube видео (скачивание + транскрибирование)
  • Поддержка файлов субтитров (SRT, VTT) и текстовых файлов (TXT)
  • Извлечение слов по уровням CEFR (A2, B1, B2)
  • Интерактивный выбор слов для колоды
  • Кеширование аудио и транскриптов
  • Генерация готовых .apkg файлов для Anki

Установка

Зависимости

Для работы с YouTube видео требуются:

  • yt-dlp — скачивание аудио
  • mlx_whisper — транскрибирование (Apple Silicon)
# macOS
brew install yt-dlp
pip install mlx-whisper

Сборка

git clone https://github.com/weazyexe/yuki-cli.git
cd yuki-cli
go build -o yuki .

Использование

Из YouTube видео

# Базовое использование
yuki https://www.youtube.com/watch?v=VIDEO_ID

# С параметрами
yuki -n 30 -l B2 -o vocabulary.apkg https://youtu.be/VIDEO_ID

Из файла субтитров

# SRT файл
yuki subtitles.srt

# VTT файл
yuki captions.vtt

# Текстовый файл
yuki transcript.txt

При использовании файлов зависимости yt-dlp и mlx_whisper не требуются.

Флаги

Флаг Короткий По умолчанию Описание
--count -n 20 Количество слов для извлечения
--output -o deck.apkg Путь к выходному файлу
--level -l B1 Уровень языка: A2, B1, B2
--api-url localhost:11434/v1 URL OpenAI-совместимого API
--api-key API ключ (или env: OPENAI_API_KEY)
--model gpt-4o-mini Название LLM модели
--no-review false Пропустить интерактивный выбор слов
--no-cache false Отключить кеширование
--refresh false Игнорировать кеш, скачать заново
--clear-cache Очистить кеш и выйти

Примеры

# Извлечь 30 слов уровня B2, пропустить выбор
yuki -n 30 -l B2 --no-review https://www.youtube.com/watch?v=abc123

# Использовать OpenAI API
yuki --api-url https://api.openai.com/v1 \
        --api-key $OPENAI_API_KEY \
        --model gpt-4o \
        video.srt

# Использовать локальный Ollama
yuki --api-url http://localhost:11434/v1 \
        --api-key ollama \
        --model llama3.2 \
        transcript.txt

Кеширование

Кеш хранится в ~/.cache/yuki/ (или $XDG_CACHE_HOME/yuki/):

  • audio/ — скачанные аудиофайлы
  • transcripts/ — транскрипты
# Очистить кеш
yuki --clear-cache

# Игнорировать кеш для одного запуска
yuki --refresh https://youtube.com/...

# Отключить кеширование
yuki --no-cache https://youtube.com/...

Поддерживаемые форматы

Формат Расширение Описание
SubRip .srt Стандартные субтитры
WebVTT .vtt Веб-субтитры
Text .txt Обычный текст

Тестирование

go test ./...

Лицензия

MIT