Lezione gratuita

Installare motore isolato e voce fissata

Installare motore isolato e voce fissata — Sintesi vocale locale con Piper. Creare un ambiente Linux separato; Acquisire provenienza prima dei pesi; Registrare integrità e distinguere guasti. Esercitazione pratica: Prove del laboratorio.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Creare un ambiente Linux separato
  • Acquisire provenienza prima dei pesi
  • Registrare integrità e distinguere guasti

Creare un ambiente Linux separato

Lavora in una cartella Linux didattica, non nel Python di sistema. I comandi sono destinati alla macchina dell’allievo: non vengono eseguiti sul Mac dell’autore o su un VPS esistente. Crea un ambiente virtuale, installa il rilascio verificato e registra le dipendenze risolte. Fissare Piper non blocca ogni dipendenza: conserva freeze e sistema operativo. Leggi l’help della versione installata prima dei flag successivi. Se pip non trova una distribuzione, confronta Python e architettura con i wheel pubblicati. Non usare pacchetti casuali o privilegi amministrativi permanenti come rimedio. Il successo è disponibilità di metadati e help; nessun audio è necessario e la sua assenza in questa fase è prevista.

Il percorso .venv esplicito evita un altro ambiente attivato accidentalmente. Conserva errori prima del nuovo tentativo: pip riuscito in un interprete diverso non prova che Piper successivo utilizzi proprio quell’installazione e le sue dipendenze.

# 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

Acquisire provenienza prima dei pesi

Scarica prima MODEL_CARD dalla revisione immutabile verificata e confronta Dataset e Training con il registro. Dopo la lettura acquisisci ONNX e JSON corrispondenti dalla stessa directory e revisione. Modello e configurazione sono una coppia: pesi nuovi con JSON vecchio possono provocare errori o parametri audio errati. La scheda richiede Piper 1.5 o superiore, soddisfatto dal rilascio 1.8.0. Registra la lingua: nl_BE è neerlandese belga, non inglese. Conserva la scheda anche se il downloader non lo fa. Se un URL fallisce fermati e controlla l’albero ufficiale, senza sostituire silenziosamente la voce con un mirror simile. Il nome del file da solo non prova provenienza o identità della versione.

Non mantenere revisioni diverse con identici nomi attivi. Archivia coppie vecchie in cartelle versionate ed esponi solo la coppia scelta in voices: ricerca del CLI e registro delle prove devono riferirsi agli stessi file.

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

Registrare integrità e distinguere guasti

Calcola SHA-256 dopo download riusciti e registra gli URL fissati. Un hash locale rileva cambiamenti successivi, ma senza riferimento pubblicato affidabile non prova chi abbia creato il file. Controlla dimensioni e stato HTTP: una pagina HTML chiamata .onnx non è un modello. Distingui installazione mancante, coppia vocale assente e configurazione malformata. Se CLI non trova la voce verifica directory e nome prima di reinstallare. Se fallisce solo una coppia ripristina quella archiviata prima di cambiare driver o pacchetti GPU. Conserva stderr del tentativo. Il risultato è una cartella di prove con metadati, scheda, coppia esatta e integrità; non dichiarare ancora verificata la qualità della voce, perché in questa fase non è stata ascoltata.

La verifica usa il digest originale salvato, non uno rigenerato dopo cambiamenti inspiegati. Altrimenti approva semplicemente byte già cambiati e perde capacità di rilevare sostituzioni o download corrotti; conserva il riferimento insieme all’errore.

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

Esercitazione pratica

Prove del laboratorio

Vai alla lezione

Programma del corso

  1. Scegliere il compito e distinguere le licenze
  2. Installare motore isolato e voce fissata
  3. Preparare testo e primo rendering controllato
  4. Verificare struttura, significato e risorse audio
  5. Creare un batch limitato di due file
  6. Consegnare un progetto TTS privato riproducibile