59. Установка SadTalker на Linux Mint (Python 3.10, CPU) — реальный опыт

от

Эта инструкция основана на реальной установке SadTalker на Linux Mint.
Процесс занял около двух дней из-за конфликтов библиотек Python, поэтому здесь собраны все рабочие решения.

Система

  • Linux Mint (основан на Ubuntu)
  • Python 3.10
  • Работа без GPU (CPU режим)
  • установка через virtualenv

1. Установка системных пакетов

Сначала ставим базовые зависимости:

sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-distutils \
python3-pip git ffmpeg build-essential libffi-dev libssl-dev

1а. Рабочая версия Python

Во время установки выяснилось, что SadTalker не всегда корректно работает с Python 3.11.
Появлялись ошибки зависимостей, в частности:

ModuleNotFoundError: No module named ‘pkg_resources’

После нескольких попыток было принято решение использовать Python 3.10.

Именно с этой версией установка прошла успешно и приложение запустилось.

Проверка версии:

python --version

Результат:

Python 3.10.x

Это оказалось наиболее стабильной конфигурацией для SadTalker.

2. Клонирование SadTalker

git clone https://github.com/OpenTalker/SadTalker.git
cd SadTalker

3. Создание виртуального окружения

python3.10 -m venv venv
source venv/bin/activate

Проверяем Python:

python --version

Должно быть:

Python 3.10.x

4. Обновление pip и setuptools

Это важный шаг, иначе появится ошибка pkg_resources.

pip install --upgrade pip setuptools wheel

5. Установка зависимостей

pip install -r requirements.txt

После этого ставим версии библиотек, которые точно работают:

pip install "numpy<1.26"
pip install scikit-image

6. Установка PyTorch (CPU)

Если нет NVIDIA:

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

7. Проверка pkg_resources

Иногда появляется ошибка:

ModuleNotFoundError: No module named 'pkg_resources'

Проверяем:

python -c "import pkg_resources"

Если ошибка есть — переустанавливаем setuptools:

pip uninstall setuptools -y
pip install setuptools

8. Запуск SadTalker

python app_sadtalker.py --cpu

После запуска появится адрес:

Running on local URL: http://127.0.0.1:7860

Открываем его в браузере.

Полезные советы

1. Не ставьте новые версии numpy

SadTalker часто ломается с numpy 1.26+.

Лучше использовать:

numpy < 1.26

2. Если сломалось виртуальное окружение

Самый быстрый способ:

rm -rf venv
python3.10 -m venv venv
source venv/bin/activate

и повторить установку.

Итог

SadTalker на Linux Mint работает стабильно при следующих условиях:

  • Python 3.10
  • numpy < 1.26
  • PyTorch CPU версия
  • чистый virtualenv

Главная сложность — зависимости Python, но после правильной установки система работает нормально.

Время установки

Реальный опыт:

  • подготовка системы — 20 минут
  • установка зависимостей — 30–60 минут
  • исправление ошибок — около 1 дня

После этого SadTalker работает стабильно.

Заключение

SadTalker можно успешно запустить на Linux Mint даже без GPU.
Главное — использовать Python 3.10, правильную версию numpy и чистое виртуальное окружение.

SadTalker на Astra Linux: почему не работает

Оставьте комментарий