Встановити ізольований рушій і закріплений голос
Встановити ізольований рушій і закріплений голос — Локальне озвучення тексту через Piper. Створити окреме Linux-середовище; Отримати походження перед вагами; Записати цілісність і розрізнити збої. Практичне завдання: Докази лабораторної роботи.
Демо-версія. Матеріали проходять редакторську перевірку.
Що розглянемо
- Створити окреме Linux-середовище
- Отримати походження перед вагами
- Записати цілісність і розрізнити збої
Створити окреме Linux-середовище
Працюйте в окремому навчальному Linux-каталозі, не в системному Python. Команди є інструкціями для машини учня: вони не виконуються на Mac автора чи наявному VPS. Створіть virtual environment, встановіть перевірений реліз Piper і запишіть розв’язані залежності. Закріплення Piper не фіксує всі залежності, тому збережіть freeze разом із параметрами ОС. Перед наступними flags прочитайте help установленої версії. За no matching distribution зіставте Python та архітектуру з опублікованими wheels. Не виправляйте це неперевіреними пакетами з пошуку або постійними правами адміністратора. Успіх — доступні метадані й help; синтезоване аудіо для перевірки встановлення не потрібне. Відсутність аудіофайла на цьому етапі очікувана, а не ознака поломки рушія.
Явний шлях .venv не дозволяє випадково використати інше активне середовище. Збережіть installation-error до повтору: успішний pip в іншому interpreter не доводить, що наступна команда Piper користується саме цим установленим пакетом і його залежностями.
# Linux learner machine only; do not run on the Mac
mkdir -p piper-lab
cd piper-lab
python3 -m venv .venv
.venv/bin/python -m pip install "piper-tts==1.8.0"
.venv/bin/python -m pip freeze > requirements.lock.txt
.venv/bin/python -m pip show piper-tts > engine-version.txt
.venv/bin/python -m piper --help > cli-help.txt
Отримати походження перед вагами
Спочатку завантажте MODEL_CARD із перевіреної незмінної ревізії й зіставте Dataset та Training із журналом прав. Лише після читання отримайте відповідні ONNX і ONNX JSON з тієї самої ревізії та каталогу. Модель і конфігурація утворюють пару: нові ваги зі старим JSON можуть дати збій або неправильні аудіопараметри. Картка вимагає Piper 1.5+, отже перевірений 1.8.0 підходить. Збережіть мову явно: nl_BE є бельгійською нідерландською, не англійською. Картку тримайте поруч, навіть якщо download-helper її не додає. За помилки URL огляньте upstream-дерево й зупиніться; не підміняйте голос схожим дзеркалом. Ім’я файла саме по собі не підтверджує ані походження, ані тотожності версії, яку ви вже перевірили.
Не тримайте різні ревізії під однаковими активними іменами. Старі пари зберігайте в архівах із ревізією, а у voices залиште вибрану пару: пошук CLI має однозначно відповідати файлам, які названі в журналі доказів цієї вправи.
mkdir -p voices
voice_revision=e7229f7d33a10e145e109b886d661984201ac3c4
voice_base="https://huggingface.co/rhasspy/piper-voices/resolve/$voice_revision/nl/nl_BE/rdh/medium"
curl --fail --location "$voice_base/MODEL_CARD" -o voices/MODEL_CARD
cat voices/MODEL_CARD
# After inspecting the card, fetch the matching pair:
curl --fail --location "$voice_base/nl_BE-rdh-medium.onnx" -o voices/nl_BE-rdh-medium.onnx
curl --fail --location "$voice_base/nl_BE-rdh-medium.onnx.json" -o voices/nl_BE-rdh-medium.onnx.json
Записати цілісність і розрізнити збої
Після успішного завантаження обчисліть SHA-256 і запишіть закріплений URL поруч. Власний хеш виявить подальшу зміну файла, але без довіреного опублікованого еталона не доводить автора. Перевірте розміри й HTTP-успіх: HTML-помилка з .onnx не є моделлю. Розрізняйте невстановлений рушій, відсутню пару голосу та пошкоджену конфігурацію. Коли CLI не знаходить голос, спочатку перевірте data-directory та ім’я, не перевстановлюйте рушій. Якщо завантаження ламається лише з однією парою, поверніть збережену узгоджену пару перед зміною драйверів чи GPU-пакетів. Збережіть stderr невдалої спроби. Результат уроку — локальна папка доказів: метадані встановлення, картка, точна пара й контроль цілісності; якість мовлення ще не перевірена й не повинна потрапити до звіту як підтверджений успіх.
Перевірка має використовувати первинно збережені digest, не нові після непоясненої зміни. Інакше вона лише підтвердить уже змінені байти й втратить здатність помітити підміну або пошкодження завантаження; збережіть попередній запис поруч із повідомленням збою.
sha256sum voices/MODEL_CARD voices/nl_BE-rdh-medium.onnx voices/nl_BE-rdh-medium.onnx.json > voice-sha256.txt
ls -lh voices
# Later integrity check, after the recorded files are retained:
sha256sum --check voice-sha256.txt
Практичне завдання
Докази лабораторної роботи
Перейти до навчання