Stap voor stap

Installeer LinguoAI op uw pc.

Hier ziet u waar u op klikt, wat u invoert en wanneer u klaar bent. Begin met stap 1. Extra opties vind je onderaan.

Begin met stap 1 Open de Colab-handleiding Zoek versie

Eenmalig instellen

Installeer op uw Windows-pc

Je hebt een Windows pc nodig met internet en ruimte voor meerdere gigabytes. Er is nog geen voltooid installatiebestand. Met de volgende stappen stelt u het programma in. Je hoeft hiervoor niet te kunnen programmeren.

01
Installeer twee hulpprogramma's

Open het Windows Startmenu, typ PowerShell en open het programma. Kopieer de volgende regels één voor één en druk voor elke regel op Enter. Wacht na elke regel totdat de installatie is voltooid.
PowerShell
```
winget install --id Python.Python.3.11 --exact --source winget
```
```
winget install --id Gyan.FFmpeg --exact --source winget
```
Python voert LinguoAI uit. FFmpeg leest en schrijft video's. Als Windows om bevestiging vraagt, controleer dan of deze bij deze installatie hoort.

Klaar? Beide installaties melden succes of “reeds geïnstalleerd”. Sluit nu PowerShell.
02

Download en pak LinguoAI uit

Download het ZIP-bestand. Klik er met de rechtermuisknop op in de downloadmap en selecteer 'Alles uitpakken'. Open vervolgens de uitgepakte map.

Download LinguoAI 2.2.2 ↓

Je hebt gelijk als je het bestand hebt pyproject.toml en de map linguoai zie.
03
Begin in de juiste map

Klik in de geopende map in de adresbalk bovenaan. Typ powershell en druk op Enter. Er wordt een nieuw venster geopend. Kopieer deze drie controleregels afzonderlijk:
PowerShell
```
py -3.11 --version
```
```
ffmpeg -version
```
```
ffprobe -version
```
U ziet Python 3.11 en twee versiedisplays. Als er 'niet gevonden' staat, gebruik dan de onderstaande hulp voordat u verdergaat.
04
LinguoAI instellen

Blijf in dit venster. Kopieer elke regel afzonderlijk en druk op Enter. Wacht tot je weer iets kunt invoeren. Grotere bestanden worden de eerste keer geladen.
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]"
```
Voltooid zonder foutmelding? Dan is de installatie voltooid. Je hebt ze maar één keer nodig.
05
Programma openen

Kopieer deze regel naar hetzelfde venster:
PowerShell
```
.\.venv\Scripts\python.exe -m linguoai
```
Het LinguoAI-venster wordt geopend. Houd de PowerShell open zolang u LinguoAI gebruikt.

Probeer het nu

Je eerste vertaalde video

Maak eerst een korte video met duidelijk gesproken taal, bijvoorbeeld 30 seconden.

Onder „Start“ op „Datei …“ klik en selecteer uw video.
Degene die jij wilt „Zielsprache“ kiezen. De brontaal kan automatisch worden herkend.
Voor deze eerste test selecteert u “Google Translate · online” en “Edge TTS · online”.
Open “Geavanceerd” → “Prestaties”. Selecteer onder 'Hardware voor spraakherkenning' de optie 'Alleen CPU'. Schakel vervolgens terug naar “Start”. De overige instellingen kunt u laten staan.
Op „Verarbeitung starten“ klik. De eerste keer laadt LinguoAI ook het spraakherkenningsmodel. Dit kan enige tijd duren.
Bij „FERTIG“ op „Video öffnen“ klik. Over „Ordner öffnen“ je vindt de video en de twee ondertitelbestanden.

Als je vastloopt

Hoe open ik LinguoAI de volgende keer?

Open uw uitgepakte LinguoAI-map opnieuw. Tik bovenaan in de adresbalk powershell. Voer gewoon de opdracht uit stap 5 uit. U hoeft de installatie niet te herhalen.

“vleugelet” wordt niet gevonden

Installeer of update Microsoft App Installer vanuit de Microsoft Store. Open vervolgens de PowerShell opnieuw en herhaal stap 1.

Open Microsoft-instructies ↗

Python of FFmpeg is niet gevonden

Sluit PowerShell en open het opnieuw zoals in stap 3. Als dat niet werkt, start u de pc opnieuw op en controleert u de drie regels opnieuw. Voor deze handleiding moet Python 3.11 zijn geïnstalleerd.

Een opdracht meldt een fout

Voer de volgende regel nog niet uit. Controleer eerst of u zich in de uitgepakte map bevindt pyproject.toml en je hebt de hele regel gekopieerd. Bewaar de exacte fouttekst als u hulp nodig heeft.

Het duurt lang of de video wordt niet voltooid

Wanneer u voor het eerst start, worden modellen gedownload. Laat het venster open en controleer of de voortgang doorgaat. Als LinguoAI een fout vertoont, lees dan het bericht in het logboek. Test dan eerst een kortere video.

Andere opties: Linux, lokale stemmen en meer

Linux

Python 3.10+ en FFmpeg vereist

# 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

Vier manieren om een voicetrack te krijgen

Vergelijk stemmen

‘Eigen stem’ kan verschillende dingen betekenen. Deze vergelijking helpt u bij het maken van de juiste keuze.

Edge TTS

De gemakkelijke manier om aan de slag te gaan met kant-en-klare stemmen uit de Microsoft-catalogus.

Online · Nee, catalogusstem

gTTS

Snelle Google Voice via Google Translate Tekst-naar-spraak met spraakcode.

Online · Nee, taalcode

Piper

Snelle lokale output met een bestaand of zelfgetraind ONNX-model.

Lokaal · CPU, optionele CUDA

Chatterbox V2

Neemt het vocale karakter en de manier van spreken over van een korte, zuivere opname.

Referentiestem · GPU aanbevolen

Voeg Piper lokaal toe

Installeer in dezelfde virtuele omgeving en laad vervolgens een geschikte stem:

.\.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 plus bijpassende JSON, optionele luidspreker-ID en instelbare spreeksnelheid.

Eigen referentiestem met Chatterbox

Vanwege de afhankelijkheden van audio/toorts wordt een speciale Python-3.11-omgeving aanbevolen:

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 seconden, één persoon, weinig galm, geen muziek of achtergrondgeluid.
Modeldownload van ongeveer 3,7 GB; CPU is mogelijk, maar erg traag voor langere video's.
De native installatie is experimenteel; Colab of Linux is betrouwbaarder bij problemen met audiopakketten.

Voor herhaalbare processen

Commandoregel

Dit voorbeeld wordt lokaal vertaald naar NLLB en gebruikt een Piper-model. Voor automatisering zijn dezelfde instellingen beschikbaar als in de GUI.

Eigen uitvoer- en modelpaden

PowerShell · Piper lokaal

.\.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"

Bekijk alle opties: .\.venv\Scripts\python.exe -m linguoai --help

Python-Wheel

Het kant-en-klare pakket voor een bestaande Python-omgeving; FFmpeg is nog steeds vereist.

Laad Wheel ↓

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

Verdeel de rekenkracht op een verstandige manier

CPU en GPU zijn geen alles-of-niets-beslissing.

Whisper, NLLB en de lokale stem kunnen afzonderlijk worden geplaatst. Je kunt dus klein beginnen en alleen dat onderdeel op de GPU zetten dat er echt baat bij heeft.

“Automatisch” controleert CUDA en valt anders terug op CPU.

Belangrijk: Als u “GPU” selecteert, wordt CUDA niet automatisch geïnstalleerd.

NLLB en Chatterbox
Een bijpassende CUDA-editie van PyTorch nodig.
PyTorch-selectie ↗
Faster-Whisper
Vereist bovendien CUDA-12-cuBLAS en cuDNN 9 in het systeempad.
Piper
Gebruikt ONNX Runtime: onnxruntime-gpu installeren in plaats van de CPU-editie.

Optioneel sneller op de CPU

Parkiet of Whisper?

Parkiet · 25 talen

NVIDIA Parakeet v3 herkent 25 Europese talen. De optionele sherpa-onnx-adapter werkt lokaal op de CPU met standaard vier schroefdraden.

NVIDIA-modelkaart ↗

Whisper · veelzijdig

Faster-Whisper blijft de standaard met automatische spraakherkenning, ruimere taalselectie en CPU- of GPU-verwerking.

Faster-Whisper ↗

De primeline fine tune is gespecialiseerd in het Duits. Selecteer hiervoor het Duitse profiel met een geschikte ONNX-export; voor meerdere Europese talen het NVIDIA profiel. Een snelheids- of kwaliteitsvoordeel is niet gegarandeerd zonder het te vergelijken met uw bestanden.

Parkiet opzetten

Installeer het optionele pakket en zorg voor een compatibele modelmap. Een model wordt niet automatisch gedownload.

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

Gebruik de volledige sherpa-onnx-modelmap met encoder, decoder, joiner en tokenbestand. Bewaar bij het exporteren naar het Duits ook het externe encoderbestand als dit bij het model hoort.

Selecteer in Desktop en Colab de map voor spraakherkenning, profiel en model. Geef de brontaal expliciet op, zodat de vertaling de juiste taalcode krijgt. Parkiet getranscribeerd; de geselecteerde vertaling en stem volgen daarna.

sherpa-onnx-modellen en opstelling ↗ · primeline-modelkaart ↗

Uploaden → Verwerken → Downloaden

Werk in de browser.

Videostudio

Voor gebruikers die studiotoegang hebben gekregen. Log in en upload video's rechtstreeks in de browser.

Verwerking op de server. Vertaling nog steeds beperkt; volledige proces nog niet bevestigd.

Geen Google-account vereist. Zonder studiotoegang kun je kiezen voor Google Colab of de desktopversie.

Open Videostudio Zoek versie

Google Colab

De Colab-webinterface accepteert al uploads en Google Drive-bestandspaden. Het verwerkt de video's op de draaiende Colab-machine en biedt video en ondertitels om te downloaden. Resultaten kunnen ook in uw schijf worden opgeslagen.

Open de Colab-handleiding Open Notebook rechtstreeks

De complete gereedschapskist

Alle functies in detail.

Bestanden en bestellingen

Verwerk een enkele video of alle video's die rechtstreeks in een map staan.
Ingangen: MP4, MKV, MOV, AVI, WEBM en M4V; Uitvoeringen: MP4, MKV of MOV.
Automatische uitvoersuggestie, botsingsvrije namen en gecontroleerd overschrijven.
Voortgang per bestand, huidige werkstap, annulering en technisch logboek.
Enkelvoudige en batchverwerking: upload meerdere video's of voer MyDrive-bestandspaden in, één per regel. Piper-bestanden en referentie-opname via upload of MyDrive-pad.

Transcriptie met Faster-Whisper

Modellen van tiny tot large-v3, bovendien eigen modelwaarden.
De brontaal automatisch detecteren of instellen als taalcode.
CPU, NVIDIA-CUDA of automatische selectie; int8, float16 en float32 configureerbaar.
Overlappende audiosecties, echte tijdverschuivingen en het opruimen van dubbele segmenten.
Bloklengtes, overlap en werknemernummer via geavanceerde opties of CLI.

Vertaal- en tekstbeveiliging

NLLB-200 lokaal, Google Translate zonder sleutel, DeepL-SDK of Gemini.
Optionele terugval alleen na expliciete selectie - anders wordt er slechts met één aanbieder contact opgenomen.
URL's, e-mailadressen, valuta's, eenheden en percentages zijn beschermd tijdens de vertaling.
Time-outs, beperkte herhalingen en cache voor identieke tekstsecties.
Optioneel corrigeert Gemini het Whisper-transcript zonder de segment-ID's of tijden te wijzigen.
Eigen NLLB-compatibele modellen, vaste revisies, FLORES-codes, batch- en tokenlimieten.

Het standaard NLLB-600M-model valt onder CC-BY-NC-4.0, is een onderzoeksmodel en geen gecertificeerde productievertaling. Controleer altijd de resultaten.

Timing, toon en export

Normaliseer elke clip naar 48 kHz mono PCM en positioneer deze met monsternauwkeurigheid.
Versnel spraak die te lang is, binnen een configureerbare limiet.
Waarschuwing bij snel accelereren; gecontroleerde fout in plaats van onbegrijpelijke output.
Exacte eindduur, overgenomen metadata/hoofdstukken en indien mogelijk ongewijzigde videostream.
Atomaire resultaatgroep uit nieuwe video, originele SRT en vertaling SRT.

Waar uw gegevens worden verwerkt

NLLB · Piper · Chatterbox
Na het downloaden in de door u gekozen termijn. In Colab betekent dit binnen de tijdelijke Google-VM.
Google · DeepL · Gemini
Ontvang alleen tekstsecties wanneer geselecteerd of als expliciet geactiveerde fallback.
Edge TTS · gTTS
Stuur elke vertaalde cue die moet worden nagesynchroniseerd naar de betreffende online taaldienst.
Beveiligde Gradio-webinterface met willekeurig wachtwoord per sessie.
Optionele modelcache en atomaire resultaatkopie in Google Drive.
Oprijpaden blijven binnen MyDrive; Drive wordt niet gedeeld als openbare downloadmap.

Tijdelijke resultaten worden pas gepubliceerd nadat de video is voltooid en beide ondertitels zijn voltooid. Afbreken, beperkte nieuwe pogingen, beveiligde bestemmingspaden en geredigeerde API-sleutels voorkomen onaangename verrassingen.

OPTIONEEL

Eigen adres bij Cloudflare Tunnel.

Met SHARE_PROVIDER = "gradio" ontvangt u automatisch een dynamische link. Google Drive is optioneel.

Cloudflare optioneel

Alleen voor uw eigen vaste adres: zet een benoemde Cloudflare-tunnel op met uw eigen domein en de service http://127.0.0.1:7860. Dit is geen openbaar geïmplementeerde LinguoAI-server.

Stel in de Notebook SHARE_PROVIDER in op "cloudflare", vul CLOUDFLARE_TUNNEL_HOSTNAME met uw eigen hostnaam en sla CLOUDFLARE_TUNNEL_TOKEN op als Colab Secret. Publiceer nooit tokens.

Cloudflare: standaard 95 MB per upload. Gradio: tot 5 GB per bestand. Gebruik voor grote video's Google Drive. Tijdelijke trycloudflare.com-links worden niet gebruikt vanwege een gebrek aan SSE-ondersteuning.

Open de Colab-handleiding