Telepítés és eltávolítás

A Live Caption Pro-nak nincs hagyományos telepítője: a szolgáltatások a forráskód tárolójából (a repóból) indulnak, és az első indításkor maguk készítik el a futtatható csomagjukat. A telepítés tehát azt jelenti, hogy a gépre felkerül minden előfeltétel, a modellek, az adatbázis és a kulcsok. Ezt egy lépésben elvégzi a beállító (setup-system); ha inkább kézzel, lépésenként haladnál, az Első indítás fejezet a sorrendet adja.

Mielőtt hozzákezdesz

• Legyen meg a repó klónja a gépen, és nézd meg a környezetellenőrző jelentését (lásd az Előfeltételek és környezetellenőrzés fejezetet).
• macOS-en előbb a PowerShell 7 kell (brew install --cask powershell), és grafikus munkamenet: a szolgáltatások Terminal-ablakban indulnak, SSH-ról ez nem megy.
• Windowson a beállítót ne rendszergazdaként futtasd: ahol jogosultság kell, ott a lépés maga kér jóváhagyást.
• Számolj nagy letöltéssel: a fordítómodellek önmagukban kb. 31 GB-ot tesznek ki.

Egy lépésben: a beállító

Windowson a setup-system.cmd, macOS-en a setup-system.command indítja a repó gyökeréből (dupla kattintással is); a -langhu ikre mindig magyarul ír.

setup-system.cmd                               # mindenen végigmegy, ahol kell, kérdez
setup-system.cmd -DataHome D:\LiveCaptionPro   # az adatok helyének megadásával
setup-system.cmd -ListSteps                    # csak kiírja, mi futna ezen a gépen
setup-system.cmd -NoTranslator                 # a fordító nélkül

A beállító sorban hívja a termék meglévő eszközeit, és mindegyik eredménye alapján dönt a továbbiakról:

Lépés	Mit tesz
előellenőrzés	megnézi, hogy nem emelt jogú ablakból fut-e, és hogy az ablak környezete friss-e
adatgyökér	megkérdezi, hova kerüljenek a termék adatai (Enterre a szokásos hely)
előfeltételek	a környezetellenőrző pótló módja (check-environment -Fix)
fordítómodell	a TranslateGemma négy változata (12b és 4b, kétféle pontossággal), kb. 31 GB
adatbázis	a fiókszolgáltatás PostgreSQL-adatbázisa
peer tokenek és fiókcím	a szolgáltatások kulcsa a fiókszolgáltatás felé, és a fiókszolgáltatás címe
a fiókszolgáltatás	elindítja, és ellenőrzi, hogy a szolgáltatások kulcsát elfogadja
futtatás	elindítja a többi szolgáltatást a napi indítóval
kliens-kulcsok	kulcs a parancssori szkripteknek és a LiveCaption alkalmazásnak

A -NoTranslator, -NoVoice és társaik kihagynak egy szolgáltatást – az előfeltételei sem töltődnek le. Ez akkor hasznos, ha az a szolgáltatás másik gépen fog futni.

A kezdő identity administrator jelszava (a felhasználókat kezelő első fiók, admin) a fiókszolgáltatás első indulásakor, egyszer jelenik meg a fiókszolgáltatás saját ablakában. Ezt az ablakot ne zárd be, amíg a jelszót el nem olvastad – a részletek az Első indítás fejezetben.

Ha megszakad, vagy újraindítást kér

Minden lépés megismételhető: a meglévőt nem írja felül. Egy megszakított futás újraindítva onnan folytatódik, ahol abbamaradt; egy kész gépen pedig minden lépésre „már rendben volt” a válasz.

• Ha a gép újraindítást kér (a WSL, a Docker Desktop első indítása vagy a docker-users csoport miatt Windowson), indítsd újra, és futtasd újra a beállítót.
• A beállító a környezeti változókat tartósan írja. Egy régi ablakból nem indul el: ha egy változó az ablakban mást tart, mint a tartós értéke, új ablakot kér.
• Ha a fiókszolgáltatás egy szolgáltatás kulcsát elutasítja, a beállító csak azt az egy kulcsot cseréli, és ezt kimondja – egy másik gép is használhatja ugyanazt a kulcsot.

A kilépési kód: 0 minden kész (vagy már rendben volt); 1 használati hiba, semmi nem változott; 4 végigfutott, de figyelmeztetéssel (egy szolgáltatás vagy kulcs kimaradt); 6 egy lépés megállt – a hiba javítása után az újrafuttatás folytatja.

Kérdések és licencek

• A -Yes mindenre igent mond, a licencekre is (a winget, a Docker Desktop és a hangmodell CPML licence, amely csak nem kereskedelmi használatot enged).
• A -NonInteractive semmit nem kérdez, és -Yes nélkül a biztonságos irányba dönt: az előfeltételeket csak jelenti, kulcsot nem ad ki, a hangmodell licencét nem fogadja el.
• Ha a licencet a beállító nem fogadta el, a beszédszolgáltatás az első indulásakor a saját ablakában kérdez rá.

Hol vannak az adatok

A termék a beállításait, a naplóit, a modelljeit és a kulcsait egy adatgyökér alá teszi. Windowson ez alapból a %LOCALAPPDATA%\LiveCaptionPro mappa, de a beállító -DataHome kapcsolójával (vagy a kérdésére) más meghajtóra is tehető; ilyenkor az LCP_HOME környezeti változó őrzi a helyet. macOS-en a beállító nem állít ilyen változót, ott a szokásos hely marad. A fordítómodellek a Hugging Face letöltő saját gyorsítótárába kerülnek (Windowson jellemzően a C: meghajtón), az adatgyökértől függetlenül.

A környezet eltávolítása

Az eltávolító (uninstall-environment.cmd) leszedi, amit a termék telepített vagy letöltött: a beszédmotor Python-környezetét, a modelleket, a fordítómotor programjait, az adatgyökeret és a publikált csomagokat.

uninstall-environment.cmd                       # jelentés: mi menne el, mekkora helyet szabadít fel
uninstall-environment.cmd -List                 # a választható csoportok
uninstall-environment.cmd -Remove               # törlés, tételenkénti kérdéssel
uninstall-environment.cmd -All -Remove -StopServices

• Alapból semmit nem töröl: a törléshez a -Remove kell, és tételenként rákérdez (a -Yes ezt is elhagyja).
• A -StopServices előbb leállítja a futó szolgáltatásokat; enélkül a használatban lévő fájlok miatt a törlés részleges maradhat.
• A gépszintű eszközök (Python, .NET SDK, PowerShell 7, virtuális hangkábel) csak külön kérésre mennek (-Groups vagy -All), mert más program is használhatja őket.
• A Docker Desktop csak kimondott kérésre megy (-Groups docker-desktop): az eltávolítása a gép minden konténerét és kötetét viszi, más projektekét is. Ha a fiókszolgáltatás adatbázisa a Dockerben maradna, kimarad. A WSL-hez nem nyúl.
• A fiókszolgáltatás adatbázisát a saját indítója törli; az adatbázis mentései megmaradnak, és a jelentés megmondja, hol.

Amihez sosem nyúl: a repó forráskódja és bármi, ami a termék saját mappáin kívül van. A kilépési kód 0, ha végigfutott, és 1, ha valamelyik tétel törlése nem sikerült.

macOS-en az eltávolítónak nincs kattintható indítója: a Homebrew-val telepített tételeket nem ismeri, ezért ott ezeket a Homebrew saját parancsával (brew uninstall) távolítsd el. A szolgáltatásként bejegyzett szolgáltatások eltávolítását a Szolgáltatásként fejezet írja le.