VoxBridge Studio logó VoxBridge StudioBeüzemelés
Beüzemelés EN
Próbalicenc
Telepítés és első indítás

Részletes beüzemelési útmutató

Ez az oldal végigvezet a telepítésen, a helyi mód FFmpeg/Ollama/modell beállításán, a saját kulcsos Cloud BYOK úton és az első sikeres próbán. A tutorial videók kiemelt használati területnek számítanak, de a program más videókhoz is használható.

Letöltés és trial Support Licencmodell
Miért van szükség beüzemelésre?

A VoxBridge Studio két beüzemelési utat támogat. Helyi módban a beszédfelismerés, fordítás és fájlfeldolgozás a saját gépeden történik, ezért ellenőrizni kell az FFmpeg, Ollama, fordítómodell és licenc állapotát. Cloud BYOK módban saját Groq vagy Gemini API-kulcsot használsz a kiválasztott cloud providerhez.

Ajánlott útvonal Letöltés → helyi vagy Cloud BYOK út kiválasztása → beüzemelés → rövid tesztvideó → ha a workflow működik, később jöhet a személyes licenc.
Simple mód

Kezdd helyi vagy Cloud BYOK választással

Új felhasználóknál a Felirat fül Simple módban indul. A helyi mód a saját gépen futó feldolgozási út. A Cloud BYOK saját Groq API-kulccsal használható ASR-re, illetve saját Gemini/Groq kulccsal LLM fordításra.

  • Helyi: FFmpeg, Ollama és letöltött TranslateGemma modell.
  • Cloud BYOK: saját provider-fiók és API-kulcs.
  • Haladó: részletes provider-kombinációk és vegyes módok.
API-kulcsok

Alapból csak sessionben

A Cloud BYOK kulcsok alapból csak az aktuális munkamenetben élnek. Ha külön bekapcsolod az “API-kulcsok megjegyzése ezen a gépen” opciót, a VoxBridge Studio Windows Credential Managerben tárolja őket.

Ha a GROQ_API_KEY, GEMINI_API_KEY vagy GOOGLE_API_KEY környezeti változó be van állítva, az app fallbackként használhatja.

Mire van szükség?

Minimális működési csomag

Az első sikerhez nem kell sok minden, de néhány alapkomponensnek meg kell lennie. Ha ezek készen vannak, a setup assistant gyorsan ellenőrzi az állapotukat.

  • Windows 10 vagy Windows 11
  • VoxBridge Studio portable ZIP csomag
  • FFmpeg
  • Ollama helyi módhoz
  • legalább egy letöltött fordítómodell helyi módhoz
  • saját Groq vagy Gemini API-kulcs Cloud BYOK módhoz
  • elegendő RAM vagy VRAM a választott modellhez
  • internet az első modellletöltéshez és licencaktiváláshoz
Letöltés

Hol kezdd?

A VoxBridge Studio használatát a letöltési oldalon érdemes kezdeni. A portable ZIP csomagot külön mappába kell kicsomagolni, majd onnan indítani az alkalmazást.

  • nyisd meg a letöltési oldalt
  • töltsd le a portable ZIP csomagot
  • csomagold ki egy külön mappába
  • az alkalmazást mindig a kicsomagolt mappából indítsd
Hardver és modellválasztás

Előbb gépigény, aztán modellletöltés

A helyben futó fordítás és beszédfelismerés sok memóriát kérhet. A modell GB mérete csak a letöltés és tárhely szempontjából beszédes; futás közben RAM vagy VRAM is kell. Gyengébb gépen ne a legnagyobb modellel kezdd.

FordítómodellAjánlott indulás
translategemma:4b
3.3 GB		gyenge gépes/no-GPU első próba és kompatibilitási fallback; nem minőségi alap
translategemma:12b
8.1 GB		ajánlott alapmodell; 24 GB RAM vagy 12 GB+ VRAM; 16 GB RAM alatt ne ezzel kezdj
translategemma:27b
17 GB		minőségi mód erős gépre; használat előtt figyelmeztetéssel, 32 GB RAM alatt kerülendő
ASR / hangból felirat

A beszédfelismerés is számításigényes

  • distil-large-v3: ajánlott alap ASR, 16 GB RAM és 6-8 GB+ VRAM ajánlott; CPU-n lassabb.
  • large-v3-turbo: gyorsabb nagy ASR opció, 16 GB RAM és 6-8 GB+ VRAM ajánlott.
  • large-v3: minőségi mód, 16-32 GB RAM és 8 GB+ VRAM ajánlott; CPU-n nagyon lassú lehet.

Első próbának meglévő SRT fordítását vagy 1-3 perces, tiszta hangú tesztvideót válassz.

Kiemelt hivatalos letöltések
FFmpeg hivatalos letöltés Ollama hivatalos letöltés
FFmpeg: videó és hangfeldolgozás Ollama: helyi modell futtatás Mindkettő hivatalos forrásból

Az aktuális app első indításkor már vezetett beüzemelést ad: FFmpeg letöltés, Ollama telepítő indítása, modellválasztás, modellletöltés, licencellenőrzés és Cloud BYOK készenlét is ellenőrizhető az appból. Az Ollama telepítő befejezése után térj vissza a VoxBridge Studiohoz, és futtasd újra az ellenőrzést. A parancsok lent kézi hibaelhárításhoz maradnak meg.

1. lépés

A VoxBridge Studio telepítése

  1. Nyisd meg a letöltési oldalt.
  2. Töltsd le a portable ZIP csomagot.
  3. Csomagold ki egy külön, könnyen megtalálható mappába.
  4. Indítsd el a VoxBridge Studio alkalmazást a kicsomagolt mappából.
  5. Indítás után hagyd, hogy az első indítási beüzemelés lefusson.
VoxBridge Studio első indítási beüzemelés
Első indítási ellenőrzés A setup assistant az FFmpeg, az Ollama, a modell, a licenc és az első próba állapotát nézi végig.
2. lépés

FFmpeg telepítése és beállítása

Az FFmpeg szükséges a videó- és hangfeldolgozáshoz. Az app első indításkor már fel tudja ajánlani az FFmpeg automatikus letöltését és beállítását.

A kézi letöltés és PATH-beállítás csak tartalék út, ha az appos beállítás valamiért nem sikerül.

  1. Indítsd el a VoxBridge Studio alkalmazást.
  2. Az első indítási beüzemelésben kattints az FFmpeg letöltése és beállítása gombra.
  3. Várd meg, amíg az app letölti, kicsomagolja és beállítja az FFmpeg-et.
  4. Futtasd újra az ellenőrzést.
  5. Ha nem sikerül, akkor kézzel is megadhatod az ffmpeg.exe útvonalát.

Gyors ellenőrzés

ffmpeg -version

Ha ez verziószámot ír ki, az FFmpeg már látszik a rendszernek.

Ha nem találja, akkor vagy nincs telepítve, vagy nincs a PATH-ban. Ilyenkor a kézi útvonalmegadás a gyorsabb megoldás.

Lépésről lépésre PowerShellben

# 1) Hozd létre a mappát
New-Item -ItemType Directory -Force -Path C:\Tools\ffmpeg

# 2) Csomagold ki ide az FFmpeg csomagot
# Ha már kicsomagoltad, ezt a lépést kihagyhatod

# 3) Ellenőrizd, hogy ott van-e az ffmpeg.exe
Get-ChildItem C:\Tools\ffmpeg -Recurse -Filter ffmpeg.exe

# 4) Add hozzá a bin mappát az aktuális session PATH-jához
$env:Path += ";C:\Tools\ffmpeg\bin"

# 5) Ellenőrzés
ffmpeg -version
where.exe ffmpeg

Ugyanez cmd-ben

mkdir C:\Tools\ffmpeg
where ffmpeg
set PATH=%PATH%;C:\Tools\ffmpeg\bin
ffmpeg -version

Ha a PATH módosítás után már működik az ffmpeg -version, de új ablakban nem, akkor a PATH-ot csak ideiglenesen adtad hozzá. Ilyenkor vagy állítsd be tartósan Windowsban, vagy add meg kézzel az appban az ffmpeg.exe útvonalát.

3. lépés

Ollama telepítése és indítása

Az Ollama futtatja a helyi fordítómodellt. Az appból már elindítható a hivatalos Windows telepítő letöltése, így nem kell kézzel keresni a letöltési oldalt.

A telepítést továbbra is a Windowsban hagyod jóvá; az app nem telepít rejtetten.

  1. Az első indítási beüzemelésben kattints az Ollama letöltése és telepítő indítása gombra.
  2. Fejezd be az Ollama telepítését a Windows telepítőben.
  3. Térj vissza a VoxBridge Studiohoz, és futtasd újra az appban a kezdeti ellenőrzést.
  4. Ha az Ollama elérhető, lépj tovább a fordítómodell letöltésére.
  5. Ha nem válaszol, indítsd újra az Ollamát vagy a gépet, majd ellenőrizd újra.

Gyors ellenőrzés

ollama --version
ollama list

Ezek csak kézi hibaelhárító parancsok. Normál esetben az appos ellenőrzés is elég.

Lépésről lépésre PowerShellben

# 1) Verzióellenőrzés
ollama --version

# 2) Megnézni, hogy válaszol-e
ollama list

# 3) Ha külön akarod elindítani a helyi szolgáltatást
ollama serve

Ugyanez cmd-ben

ollama --version
ollama list
ollama serve

Az ollama serve általában csak akkor kell, ha az Ollama nincs már elindítva. Ha a telepítés után az ollama list működik, akkor sokszor nem kell kézzel külön indítani.

4. lépés

Fordítómodell letöltése

A beüzemelési ablakban egy helyen választhatod ki a fordítómodellt és indíthatod a letöltését. Első körben egyetlen modell letöltése is elég.

  1. Válassz modellt az első indítási beüzemelés Fordítómodell részében.
  2. Ha a gép gyengébb vagy bizonytalan vagy, kezdd a translategemma:4b modellel.
  3. Ha van 24 GB RAM vagy 12 GB+ VRAM, a translategemma:12b jó alapmodell.
  4. Kattints a Kiválasztott modell letöltése gombra.
  5. Várd meg, amíg a letöltés befejeződik.
  6. Futtasd újra az ellenőrzést; a modell állapotának rendben kell lennie.

Ajánlott modellek

ollama pull translategemma:4b
ollama pull translategemma:12b
ollama pull translategemma:27b

A translategemma:4b gyenge gépes első próba és kompatibilitási modell, nem minőségi alap. A translategemma:12b az ajánlott alapmodell, de 16 GB RAM alatt nem jó első választás. A translategemma:27b általában jobb fordítási minőséget ad, de erős gépet kér, használat előtt figyelmeztetést ad, és 32 GB RAM alatt nem ajánlott.

Nem kell mindhárom modellt letölteni. Első próbához válassz egyet, és csak később próbálj másikat.

Kézi PowerShell / cmd parancsok

# Gyorsabb, gyengébb gépekre ajánlott modell
ollama pull translategemma:4b

# Alapértelmezett, kiegyensúlyozott modell
ollama pull translategemma:12b

# Nagyobb, jellemzően jobb minőségű modell
ollama pull translategemma:27b

# Ellenőrzés
ollama list

Gyors működési próba

ollama run translategemma:4b "Translate to Hungarian: Hello, this is a short test."

ollama run translategemma:12b "Translate to Hungarian: Hello, this is a short test."

ollama run translategemma:27b "Translate to Hungarian: Hello, this is a short test."

Ha az ollama run visszaad értelmes fordítást, akkor a modell tényleg fut. A weboldalon a 27b azért szerepel külön is, mert nehéz minőségi mód erős gépekre.

Rendszerkövetelmények

Mi kell a stabil induláshoz?

MinimumAjánlott
Windows 10 vagy újabb
FFmpeg telepítve
futó Ollama
16 GB RAM vagy 6 GB+ VRAM a 4b próbához
12b nem ajánlott 16 GB RAM alatt
SSD tárhely 		Windows 11
24 GB RAM vagy 12 GB+ VRAM a 12b modellhez
32-64 GB RAM vagy 24 GB+ VRAM a 27b modellhez
gyors SSD
erősebb CPU vagy GPU
stabil internet az első modellletöltéshez

4b, 12b vagy 27b?

  • translategemma:4b: 3.3 GB, gyenge gépes első próba vagy kompatibilitási fallback; nem minőségi alap
  • translategemma:12b: 8.1 GB, ajánlott alapmodell; 24 GB RAM vagy 12 GB+ VRAM mellett érdemes kezdeni
  • translategemma:27b: 17 GB, nehéz minőségi mód explicit figyelmeztetéssel; 32-64 GB RAM vagy 24 GB+ VRAM ajánlott
  • ha bizonytalan vagy vagy gyengébb géped van, kezdd 4b-vel és rövid teszttel
  • ha a minőség fontosabb, csak erős gépen próbáld ki a 27b-t
5. lépés

Első indítási beüzemelés

  1. Indítsd el a VoxBridge Studio alkalmazást.
  2. Nyisd meg az első indítási beüzemelést, ha nem ugrik fel automatikusan.
  3. Ellenőrizd az FFmpeg és licenc állapotát, majd a helyi módú Ollama/modell vagy Cloud BYOK provider/kulcs készenlétet.
  4. Ha a beüzemelés hiányzó lépést jelez, javítás után futtasd újra az ellenőrzést.
  5. Aktiváld a trialt vagy a licencet, ha már megvan.
  6. Futtasd le a rövid első próbaellenőrzést.

A cél itt nem a tökéletes eredmény, hanem az első sikeres zöld állapot.

Mit nézz meg az appban?

  1. FFmpeg állapot legyen rendben.
  2. Ollama legyen elérhető.
  3. A letöltött modell jelenjen meg.
  4. Trial vagy licenc állapot legyen zöld.
  5. Az első teszt indítható legyen.

Mit kell zöldnek látnod?

  • FFmpeg elérhető
  • Ollama fut
  • van letöltött fordítómodell
  • a licenc vagy a trial rendben
  • az első próba elindítható

Gyengébb gépen az Ollama válasza lassabb lehet. Ilyenkor a kisebb modell és az újraellenőrzés a legjobb első lépés.

6. lépés

Első sikeres próba

Az első teszthez ne fontos, hosszú anyaggal kezdj. Egy rövid, nem privát videó vagy meglévő sidecar felirat sokkal jobb első kör.

  1. Válassz 1-3 perces videót.
  2. Ha van hozzá sidecar felirat, azzal kezdj.
  3. Ha nincs, próbáld meg a hangból készülő feliratot.
  4. Mentés után nézd meg a nyelvkódos outputot, például VideoNev.hu.srt.
  5. Ha minden rendben, készen állsz egy hosszabb anyagra is.
VoxBridge Studio fájlok és feldolgozási sor
Fő munkafolyamat A fájlok, a sor és a kimenet egy helyen követhető, ezért az első próba is átlátható marad.
Ha elakadsz

Mit ellenőrizz először?

  • az FFmpeg tényleg elérhető-e
  • az Ollama fut-e
  • a modell le van-e töltve
  • a trial / licenc állapot zöld-e
  • nem túl hosszú vagy nem túl privát videóval próbálkozol-e

Support export

Ha továbbra sem indul el valami, készíts support bundle-t, és küldd el a support e-mailre. Ez tartalmazhat logot, beállítást és technikai állapotot.

Összefoglaló A teljes út nagyon röviden ez: letöltés, telepítés, FFmpeg és licenc ellenőrzés, majd helyi módban Ollama/modell vagy Cloud BYOK módban provider/kulcs ellenőrzés, setup assistant, rövid tesztvideó. Ha ez megvan, a termék működési alapja készen áll, és a következő döntés már csak a később véglegesített személyes licenc.