This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Полная инструкция по установке

Это руководство проведет вас через все шаги, необходимые для запуска Vel4Twi.

Шаг 1: Установка пререквизитов

Перед началом работы убедитесь, что у вас установлены следующие компоненты:

1. Python 3.9+

   • Скачайте с официального сайта python.org.
   • Важно: Во время установки в Windows обязательно поставьте галочку Add Python to PATH.

2. Git

   • Необходим для клонирования репозитория. Скачайте с git-scm.com.

3. PyTorch (библиотека для нейронных сетей)

   • Это самая важная зависимость. Ее нужно установить до всего остального.
   • Если у вас есть видеокарта NVIDIA (рекомендуется):
     1. Откройте командную строку и введите nvidia-smi, чтобы убедиться, что драйверы установлены и карта видна.
     2. Перейдите на официальный сайт PyTorch.
     3. Выберите Stable, вашу ОС, Pip, Python и нужную версию CUDA. Сайт сгенерирует для вас команду. Она будет выглядеть примерно так:

        pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
        

   • Если у вас нет видеокарты NVIDIA (будет работать на CPU, но медленнее):
     • На сайте PyTorch выберите CPU в качестве Compute Platform. Команда будет выглядеть так:

       pip3 install torch torchvision torchaudio
       

4. FFmpeg

   • Необходим для обработки аудио в Discord.
   • Windows: Скачайте с ffmpeg.org, распакуйте архив и добавьте путь к папке bin в системную переменную PATH.
   • Linux (Debian/Ubuntu):

     sudo apt update && sudo apt install ffmpeg
     

Шаг 2: Клонирование и настройка проекта

1. Откройте терминал (Command Prompt, PowerShell или Terminal).

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

   git clone https://github.com/your-username/Vel4Twi.git
   cd Vel4Twi
   

3. Создайте и активируйте виртуальное окружение (рекомендуется):

   # Создаем окружение
   python -m venv venv
   
   # Активируем его
   # Windows
   venv\Scripts\activate
   # Linux / macOS
   source venv/bin/activate
   

4. Установите все остальные зависимости:

   pip install -r requirements.txt
   

Шаг 3: Установка внешних приложений

1. LM Studio: Приложение для запуска локальных LLM. Скачайте и установите.
2. VTube Studio: Приложение для управления вашим 2D-аватаром. Установите через Steam.
3. VB-CABLE: Виртуальный аудиокабель для передачи голоса Velpur в VTube Studio для Lip Sync. Скачайте и установите.

После выполнения всех этих шагов вы готовы к настройке проекта. Переходите к следующей странице: Настройка config.json.