Passo dopo passo

Prepara LinguoAI sul tuo PC.

Qui trovi dove fare clic, cosa scrivere e come capire quando hai finito. Inizia dal passaggio 1. Trovi altre opzioni in fondo alla pagina.

Preparare una volta sola

Installare sul tuo PC Windows

Ti serve un PC Windows con Internet e diversi gigabyte di spazio libero. Non è ancora disponibile un file di installazione pronto all’uso. I passaggi seguenti preparano il programma. Non serve saper programmare.

  1. 01

    Installare due programmi di supporto

    Apri il menu Start di Windows e scrivi PowerShell e apri il programma. Copia le righe seguenti una alla volta e premi Invio dopo ciascuna. Aspetta che l’installazione finisca prima di passare alla riga successiva.

    PowerShell
    winget install --id Python.Python.3.11 --exact --source winget
    winget install --id Gyan.FFmpeg --exact --source winget

    Python esegue LinguoAI. FFmpeg legge e crea i video. Se Windows chiede una conferma, verifica che riguardi questa installazione.

    Fatto? Entrambe le installazioni indicano che sono riuscite o che il programma è già installato. Ora chiudi PowerShell.

  2. 02

    Scaricare ed estrarre LinguoAI

    Scarica il file ZIP. Nella cartella dei download, fai clic sul file con il tasto destro e scegli «Estrai tutto». Poi apri la cartella estratta.

    Scarica LinguoAI 2.2.2 ↓

    Sei nella cartella giusta se vedi il file pyproject.toml e la cartella linguoai in quella cartella.

  3. 03

    Partire dalla cartella giusta

    Nella cartella aperta, fai clic sulla barra degli indirizzi in alto. Scrivi powershell e premi Invio. Si apre una nuova finestra. Copia queste tre righe di verifica una alla volta:

    PowerShell
    py -3.11 --version
    ffmpeg -version
    ffprobe -version

    Vedrai Python 3.11 e altri due numeri di versione. Se compare «non trovato», consulta l’aiuto qui sotto prima di continuare.

  4. 04

    Preparare LinguoAI

    Rimani in questa finestra. Copia una riga alla volta e premi Invio. Ogni volta, aspetta di poter scrivere di nuovo. La prima volta vengono scaricati file di grandi dimensioni.

    PowerShell
    py -3.11 -m venv .venv
    .\.venv\Scripts\python.exe -m pip install --upgrade pip
    .\.venv\Scripts\python.exe -m pip install torch --index-url https://download.pytorch.org/whl/cpu
    .\.venv\Scripts\python.exe -m pip install -e ".[desktop]"

    È terminato senza errori? La preparazione è completa. Basta farla una volta sola.

  5. 05

    Aprire il programma

    Copia questa riga nella stessa finestra:

    PowerShell
    .\.venv\Scripts\python.exe -m linguoai

    Si apre la finestra di LinguoAI. Lascia PowerShell aperto mentre usi LinguoAI.

Prova adesso

Il tuo primo video tradotto

Inizia con un breve video in cui si parla chiaramente, per esempio di 30 secondi.

  1. In „Start“ fai clic su „Datei …“ e seleziona il tuo video.
  2. Scegli la lingua desiderata in „Zielsprache“ . La lingua originale può essere rilevata automaticamente.
  3. Per questa prima prova, scegli «Google Translate · online» e «Edge TTS · online».
  4. Apri «Erweitert» → «Leistung». In «Hardware für Spracherkennung», scegli «Nur CPU». Poi torna a «Start». Puoi lasciare le altre impostazioni come sono.
  5. Fai clic su „Verarbeitung starten“ . La prima volta, LinguoAI scarica anche il modello per il riconoscimento vocale. Può richiedere un po’ di tempo.
  6. Quando compare „FERTIG“ fai clic su „Video öffnen“ . Tramite „Ordner öffnen“ trovi il video e i due file dei sottotitoli.

Se non riesci a proseguire

Come apro LinguoAI la prossima volta?

Apri di nuovo la cartella estratta di LinguoAI. Scrivi nella barra degli indirizzi in alto powershell. Esegui solo il comando del passaggio 5. Non devi ripetere l’installazione.

«winget» non viene trovato

Installa o aggiorna «Programma di installazione app» di Microsoft dal Microsoft Store. Poi riapri PowerShell e ripeti il passaggio 1.

Apri la guida di Microsoft ↗
Python o FFmpeg non viene trovato

Chiudi PowerShell e riaprilo come nel passaggio 3. Se non basta, riavvia il PC e verifica di nuovo le tre righe. Per questa guida deve essere installato Python 3.11.

Un comando segnala un errore

Non eseguire ancora la riga successiva. Controlla prima di essere nella cartella estratta che contiene pyproject.toml e di aver copiato l’intera riga. Conserva il testo esatto dell’errore nel caso serva aiuto.

Ci vuole molto tempo o il video non viene completato

Al primo avvio vengono scaricati i modelli. Lascia aperta la finestra e controlla che il lavoro avanzi. Se LinguoAI mostra un errore, leggi il messaggio nel registro. Poi prova con un video più corto.

Altre opzioni: Linux, voci locali e altro
Linux

Python 3.10+ e FFmpeg richiesti

# FFmpeg, ffprobe und Tkinter über die Paketverwaltung installieren.
# Im entpackten Projektordner:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install torch --index-url https://download.pytorch.org/whl/cpu
python -m pip install -e ".[desktop]"
ffmpeg -version
ffprobe -version
python -m linguoai

Quattro modi per ottenere una traccia vocale

Confronta le voci

La “propria voce” può significare cose diverse. Questo confronto ti aiuterà a fare la scelta giusta.

Edge TTS

Il modo più semplice per iniziare con le voci già pronte dal catalogo Microsoft.

In linea · No, voce catalogo

gTTS

Google Voice veloce tramite sintesi vocale Google Translate con codice vocale.

In linea · No, codice della lingua

Piper

Output locale veloce con un modello ONNX esistente o autoaddestrato.

Locale · CPU, opzionale CUDA

ChatterboxV2

Adotta il carattere vocale e il modo di parlare da una registrazione breve e pulita.

Voce di riferimento · Consigliato GPU

Aggiungi Piper localmente

Installa nello stesso ambiente virtuale e quindi carica una voce adatta:

.\.venv\Scripts\python.exe -m pip install -e ".[desktop,piper]"
New-Item -ItemType Directory -Force ".\Stimmen"
.\.venv\Scripts\python.exe -m piper.download_voices --download-dir ".\Stimmen" de_DE-thorsten-medium

Piper: ONNX più JSON corrispondente, ID altoparlante opzionale e velocità di conversazione regolabile.

Voce di riferimento propria con Chatterbox

A causa delle dipendenze audio/torcia, si consiglia un ambiente Python-3.11 dedicato:

py -3.11 -m venv .venv-chatterbox
.\.venv-chatterbox\Scripts\python.exe -m pip install --upgrade pip
.\.venv-chatterbox\Scripts\python.exe -m pip install -e ".[desktop,voice-clone]"
.\.venv-chatterbox\Scripts\python.exe -m linguoai
  • 6-10 secondi, una persona, poco riverbero, nessuna musica o rumore di fondo.
  • Download del modello da circa 3,7 GB; CPU è possibile, ma molto lento per i video più lunghi.
  • L'installazione nativa è sperimentale; Colab o Linux sono più affidabili per i problemi dei pacchetti audio.

Per processi ripetibili

Riga di comando

Questo esempio si traduce localmente in NLLB e utilizza un modello Piper. Per l'automazione sono disponibili le stesse impostazioni dello GUI.

Propri output e percorsi del modello

PowerShell · Piper localmente
.\.venv\Scripts\python.exe -m linguoai `
  --input "C:\Videos\quelle.mp4" `
  --output "C:\Videos\quelle.de.mp4" `
  --language de `
  --service nllb `
  --device cpu `
  --nllb-device cpu `
  --tts-engine piper `
  --tts-device cpu `
  --piper-model "C:\Stimmen\de_DE-thorsten-medium.onnx" `
  --piper-config "C:\Stimmen\de_DE-thorsten-medium.onnx.json"

Visualizza tutte le opzioni: .\.venv\Scripts\python.exe -m linguoai --help

Python-Wheel

Il pacchetto finito per un ambiente Python esistente; FFmpeg è ancora necessario.

Carica Wheel ↓

python -m pip install ".\linguoai-2.2.2-py3-none-any.whl[desktop]"
python -m linguoai

Distribuire in modo sensato la potenza di calcolo

CPU e GPU non sono una decisione tutto o niente.

Whisper, NLLB e la voce locale possono essere posizionati separatamente. Quindi puoi iniziare in piccolo e mettere sullo GPU solo la parte che ne trae davvero beneficio.

"Automatico" controlla CUDA e altrimenti torna a CPU.

Importante: selezionando "GPU" non si installa automaticamente CUDA.
  • NLLB e Chatterbox

    È necessaria un'edizione CUDA corrispondente di PyTorch.

    Selezione PyTorch ↗
  • Faster-Whisper

    Inoltre richiede CUDA-12-cuBLAS e cuDNN 9 nel percorso di sistema.

  • Piper

    Utilizza il tempo di esecuzione ONNX: onnxruntime-gpu installare al posto dell'edizione CPU.

Riconoscimento più veloce facoltativo sulla CPU

Parakeet o Whisper?

Parakeet · 25 lingue

NVIDIA Parakeet v3 riconosce 25 lingue europee. L'adattatore facoltativo sherpa-onnx lavora in locale sulla CPU con quattro thread per impostazione predefinita.

Scheda del modello NVIDIA ↗

Whisper · versatile

Faster-Whisper resta l'opzione predefinita, con rilevamento automatico della lingua, una scelta più ampia di lingue ed elaborazione su CPU o GPU.

Faster-Whisper ↗

Il modello adattato di primeline è specializzato in tedesco. Per usarlo, scegli il profilo tedesco con un'esportazione ONNX compatibile; per più lingue europee, il profilo NVIDIA. Non è garantito un vantaggio di velocità o qualità senza un confronto sui tuoi file.

Configurare Parakeet

Installa il pacchetto facoltativo e prepara una cartella con un modello compatibile. I modelli non vengono scaricati automaticamente.

.\.venv\Scripts\python.exe -m pip install -e ".[parakeet]"
.\.venv\Scripts\python.exe -m linguoai --help

Usa la cartella completa del modello sherpa-onnx con encoder, decoder, joiner e file dei token. Per l'esportazione tedesca, conserva anche il file esterno dell'encoder se fa parte del modello.

Nell'app desktop e in Colab, scegli il motore di riconoscimento vocale, il profilo e la cartella del modello. Specifica esplicitamente la lingua di origine, così la traduzione riceve il codice lingua corretto. Parakeet trascrive; seguono la traduzione e la voce scelte.

Modelli e configurazione di sherpa-onnx ↗ · Scheda del modello primeline ↗

Caricamento → elaborazione → download

Lavora nel browser.

Video Studio

Per chi ha ricevuto l'accesso a Studio. Accedi e carica i video direttamente dal browser.

Elaborazione sul server. La traduzione è ancora limitata; il funzionamento dell'intero flusso non è ancora confermato.

Non serve un account Google. Se non hai accesso a Studio, puoi scegliere Google Colab o la versione desktop.

Google Colab

L'interfaccia web Colab accetta già caricamenti e percorsi di file Google Drive. Elabora i video sulla macchina Colab attiva e consente di scaricare il video e i sottotitoli. Puoi anche salvare i risultati nel tuo Drive.

La cassetta degli attrezzi completa

Tutte le funzioni in dettaglio.

File e ordini
  • Elabora un singolo video o tutti i video direttamente contenuti in una cartella.
  • Ingressi: MP4, MKV, MOV, AVI, WEBM e M4V; Edizioni: MP4, MKV o MOV.
  • Suggerimento di output automatico, nomi senza collisioni e sovrascrittura controllata.
  • Avanzamento per file, fase di lavoro corrente, cancellazione e registro tecnico.
  • Elaborazione singola e in batch: carica più video o inserisci i percorsi dei file su MyDrive, uno per riga. Carica i file Piper e la registrazione di riferimento oppure indica i loro percorsi MyDrive.
Trascrizione con Faster-Whisper
  • Modelli di tiny fino a quando large-v3, possiedono inoltre valori di modello.
  • Rileva automaticamente la lingua di origine o imposta come codice lingua.
  • CPU, NVIDIA-CUDA o selezione automatica; int8, float16 e float32 configurabili.
  • Sezioni audio sovrapposte, offset in tempo reale e pulizia dei segmenti duplicati.
  • Lunghezze dei pezzi, sovrapposizione e numero lavoratore tramite opzioni avanzate o CLI.
Traduzione e protezione del testo
  • NLLB-200 locale, Google Translate senza chiave, DeepL-SDK o Gemini.
  • Fallback opzionale solo dopo selezione esplicita, altrimenti verrà contattato solo un fornitore.
  • URL, indirizzi e-mail, valute, unità e percentuali sono protetti durante la traduzione.
  • Timeout, ripetizioni limitate e cache per sezioni di testo identiche.
  • Facoltativamente, Gemini corregge la trascrizione Whisper senza modificare gli ID o gli orari dei segmenti.
  • Possiedi modelli compatibili NLLB, revisioni fisse, codici FLORES, limiti batch e token.

Il modello NLLB-600M predefinito è sotto CC-BY-NC-4.0, è un modello di ricerca e non una traduzione di produzione certificata. Controlla sempre i risultati.

Timing, tono ed esportazione
  • Normalizza ogni clip su PCM mono a 48 kHz e posizionala con precisione al campione.
  • Accelera il discorso troppo lungo entro un limite configurabile.
  • Avvertimento in caso di accelerazione rapida; errore controllato invece di output incomprensibile.
  • Durata finale esatta, metadati/capitoli adottati e, se possibile, flusso video invariato.
  • Gruppo di risultati atomici dal nuovo video, SRT originale e traduzione SRT.
Dove vengono trattati i tuoi dati
  • NLLB · Piper · Chatterbox

    Dopo il download nel termine prescelto. In Colab ciò significa all'interno della VM temporanea di Google.

  • Google · DeepL · Gemini

    Ricevi sezioni di testo solo quando selezionate o come fallback esplicitamente attivato.

  • Edge TTS · gTTS

    Invia ogni battuta tradotta da doppiare al rispettivo servizio linguistico online.

  • Interfaccia web Gradio protetta con password casuale per sessione.
  • Cache del modello opzionale e copia atomica dei risultati in Google Drive.
  • I percorsi di guida rimangono all'interno di MyDrive; Drive non è condiviso come cartella di download pubblica.

I risultati temporanei non verranno pubblicati fino al completamento del video ed entrambi i sottotitoli. Interruzione, tentativi limitati, percorsi di destinazione protetti e chiavi API oscurate evitano spiacevoli sorprese.

FACOLTATIVO

Il tuo indirizzo con Cloudflare Tunnel.

Con SHARE_PROVIDER = "gradio" ricevi automaticamente un link dinamico. Google Drive è facoltativo.

Cloudflare facoltativo

Solo per un indirizzo fisso personale: configura un Cloudflare Tunnel con nome, il tuo dominio e il servizio http://127.0.0.1:7860. Non è un server LinguoAI fornito al pubblico.

Nel Notebook imposta SHARE_PROVIDER su "cloudflare", inserisci il tuo nome host in CLOUDFLARE_TUNNEL_HOSTNAME e salva CLOUDFLARE_TUNNEL_TOKEN come Colab Secret. Non pubblicare mai il token.

Cloudflare: 95 MB per caricamento per impostazione predefinita. Gradio: fino a 5 GB per file. Usa Google Drive per i video grandi. I link temporanei trycloudflare.com non vengono usati perché non supportano SSE.

Aprire il manuale Colab