Előfeltételek és környezetellenőrzés

Mielőtt bármit telepítenél, érdemes megtudni, hol tart a gép. A Live Caption Pro ehhez egyetlen parancsot ad, a környezetellenőrzőt (check-environment): végignéz minden előfeltételt, és megmondja, mi van meg, mi hiányzik, és mi a pótlás parancsa. Ez a fejezet először azt sorolja fel, mire van szükség, utána azt, hogyan dolgozik az ellenőrző.

Melyik rendszeren mi fut

Szolgáltatás	Windows	macOS
fiókszolgáltatás	x64; az adatbázis (PostgreSQL) Docker Desktopban	Apple Silicon; az adatbázis a Homebrew-val telepített PostgreSQL
fordító	x64, NVIDIA-kártyával	Apple Silicon (Metal-gyorsítás)
beszédszolgáltatás	x64, NVIDIA-kártyával (CUDA)	Apple Silicon
feliratozó	x64	Apple Silicon (Metal-gyorsítás)

Intel processzoros Macen a szolgáltatások nem futnak. Linuxon (x64) is futnak, ott szolgáltatásként telepítve – erről a Szolgáltatásként fejezet szól.

Ami mindenképp kell

• .NET 10 SDK – ebből készül a szolgáltatások futtatható csomagja az első indításkor.
• PowerShell 7 (pwsh) – az indítók ezen futnak. Windowson a beépített Windows PowerShell 5.1 is elég; macOS-en a PowerShell 7 nélkül egyetlen indító sem indul el, és ezt meg is mondja.
• Python 3.10–3.12 a beszédszolgáltatás motorjához. A 3.13 és a Microsoft Store-ból telepített Python nem jó; macOS-en a 3.12 az alap.
• PostgreSQL (14-es vagy újabb főverzió) a fiókszolgáltatás adatbázisához. Nem kell előre telepítened: Windowson a mellékelt indító Docker-konténerben futtatja, macOS-en a Homebrew postgresql@18 csomagjával.
• Internetkapcsolat az első futáshoz – a modellek és a futtatókörnyezetek letöltéséhez. Utána minden a gépen, internet nélkül működik.
• Windowson a winget csomagkezelő: a .NET SDK, a PowerShell 7 és a Python telepítése azon megy. A Windows 11 alapból hozza; Windows 10-en és az LTSC-kiadásokon egyszer kézzel kell telepíteni, mert a környezetellenőrző ezt az egyet nem tudja pótolni.

Videokártya és memória

A fordító, a feliratozó és a beszédszolgáltatás videokártyával gyors. Windowson NVIDIA-kártya kell; macOS-en az Apple Silicon közös (egységes) memóriája és Metal-gyorsítása dolgozik. Videokártya nélkül a feliratozó és a fordító magától processzorra vált – lassabban, és ezt ki is mondja.

Hivatalos memória-minimum nincs, csak mért számok. Egy RTX 5090-es gépen a három modellszolgáltatás együtt 22,3 GB videómemóriát használt. Külön-külön: a fordító a nagy (12b) modellel 16,7 GB, a kicsivel (4b) 5,0 GB; a beszédszolgáltatás 2,3 GB; a feliratozó a szabad videómemóriához igazodik. Ha a kártya kevés, a szolgáltatások szétoszthatók több gépre – lásd a Távoli GPU-szerver, több munkaállomás fejezetet.

A letöltések nagyjából: Whisper-modell 0,1–3 GB, fordítómodell (TranslateGemma) 7–17 GB változatonként, a beszédmotor környezete kb. 3 GB, a hangmodell (XTTS-v2) kb. 1,8 GB. Hagyj elég szabad helyet a lemezen.

A környezetellenőrző futtatása

A repó gyökerében Windowson a check-environment.cmd, macOS-en a check-environment.command indítja – dupla kattintással is. A -langhu végű ikre (check-environment-langhu.cmd) mindig magyarul ír; a sima a gép nyelvét követi.

check-environment.cmd                     # jelentés: mi van meg, mi hiányzik, mi a parancs
check-environment.cmd -Components voice   # csak a beszédszolgáltatás előfeltételei
check-environment.cmd -Fix                # pótlás: tételenként megkérdezi és elvégzi
check-environment.cmd -Fix -Yes           # pótlás kérdés nélkül: mindenre igen

A jelentés semmit nem módosít: nem telepít, nem tölt le, nem hoz létre mappát – nyugodtan futtathatod egy idegen gépen is. A táblázat jelölései:

Jel	Jelentése
+	megvan
!	hiányzik, és nélküle a komponens el sem indul
-	hiányzik, de nem kötelező
?	nem eldönthető, mert maga a vizsgálat hibázott

A futás végén a kilépési kód 0, ha minden kötelező tétel megvan, és 1, ha valamelyik hiányzik.

A -Components kapcsolóval szűkítheted a vizsgálatot: common (mindenre érvényes), captionserver (feliratozó), captionclient (a kötegelt feliratozó kliens), translator (fordító), voice (beszédszolgáltatás), cable (virtuális hangkábel), account (a fiókszolgáltatás adatbázisa). Vesszővel többet is megadhatsz.

Pótlás: a -Fix kapcsoló

A -Fix pótló módra vált: minden hiányzó tételnél megkérdezi, pótolja-e, és előre megmondja, mekkora a letöltés, és kell-e hozzá rendszergazdai jog. Rendszergazdai jogot csak az a lépés kér, amelyiknek kell (Windowson a virtuális hangkábel és a WSL; a Docker Desktop telepítője maga kéri) – minden más a saját felhasználódként települ, így a Python, a környezet és a modellek a te profilodba kerülnek. Ha a jóváhagyást elutasítod, az a tétel kimarad, a többi lefut.

A -Yes mindenre igent mond, a licencekre is: a winget megállapodásait, a Docker Desktopét és a hangmodell (XTTS-v2) CPML licencét – ez utóbbi csak nem kereskedelmi használatot enged. Csak akkor add meg, ha ezzel tisztában vagy. A -Yes önmagában, -Fix nélkül hibás használat.

Amit a pótlás nem tud magától elvégezni, annak a parancsát kiírja: Windowson a hiányzó wingetet, macOS-en a Homebrew-val telepítendő tételeket (például brew install --cask powershell, brew install blackhole-2ch), mert azok rendszergazdai jelszót kérnek. A fordítómodell letöltése sem itt történik, hanem a telepítés során – lásd a Telepítés és eltávolítás fejezetet.

Windows és macOS: a különbségek

• Virtuális hangkábel: Windowson a VB-CABLE, macOS-en a BlackHole. Csak a hívásokban használt kábeles hangforráshoz és a kimenő tolmácsoláshoz kell, ezért nem kötelező. macOS-en a BlackHole telepítése után a hangrendszer újraindítása (vagy a gép újraindítása) kellhet; az ellenőrző ezt külön jelzi.
• Docker és WSL: Windowson akkor kötelező, ha a fiókszolgáltatás ezen a gépen fut, és az adatbázisa a gép saját konténere. A WSL a Docker Desktop alapja; ha a processzor virtualizációja a BIOS-ban ki van kapcsolva, a Docker Desktop nem indul el, és az ellenőrző erre figyelmeztet. macOS-en sem Docker, sem WSL nem kell: az adatbázis natívan fut.
• Távoli fiókszolgáltatás: ha a fiókszolgáltatás másik gépen fut, vagy külső adatbázist használ, ezen a gépen a Docker és a WSL nem kötelező, és a -Fix -Yes nem is telepíti őket.

Az indítók is ellenőriznek

Ugyanezt a leltárt használja minden szolgáltatás indítója is, csak a saját komponensére, csendben: a táblázat csak akkor jelenik meg, ha valami hiányzik. Ami tehát a környezetellenőrző jelentésében zöld, az indításkor sem fog kérdezni.

A következő lépés a Telepítés és eltávolítás.