Ugrás a fő tartalomra

Gyors kezdés

Követelmények​

KövetelményMinimumAjánlott
Node.js22.22+Legújabb LTS
RAM8 GB16 GB+
Lemez5 GB20 GB+ modellekhez
GPUOpcionális8 GB+ VRAM a gyors helyi inferenciához
DockerOpcionálisA Work használatához szükséges

A Libre WebUI csak CPU-val is működik az Ollamával, de kisebb modellek illenek hozzá jobban. Cloud-bővítményekhez csak a megfelelő API-kulcs szükséges.

A Chat, a dokumentumok, az artefaktumok és a szolgáltatói funkciók nem igényelnek Dockert. A Workhoz Docker szükséges a backend gépén, és a folyamatnak engedéllyel kell rendelkeznie a meghívásához. Az npx libre-webui nem telepít Dockert. Docker nélkül az alkalmazás többi része működik, a Work pedig Runtime unavailable állapotot jelez; a modell parancsai tartalékmegoldásként sem futnak a hoston.

A Libre WebUI elindítása​

npx libre-webui@latest

Nyissa meg a http://localhost:8080 címet. Az első fiók rendszergazdává válik. A további nyilvános regisztráció zárva marad, hacsak nem állítja be az ENABLE_SIGNUP=true értéket.

A csomagolt indító a tartós állapotot a ~/.libre-webui helyen tárolja. Másik helyhez adjon meg abszolút DATA_DIR értéket; a relatív értékek abból a mappából oldódnak fel, ahol az npx fut.

Az Ollama telepítése​

Telepítse az Ollamát, majd töltsön le egy kisebb általános modellt:

ollama pull gemma4:12b

További jó lehetőségek: gemma4:26b (MoE), gemma4:31b (dense) és qwen3.8:27b. A Model Manager megmutatja a telepített modelleket, keres az Ollama Libraryban, és az alkalmazásból tölti le őket.

Dokumentumbeágyazások

A szemantikus kereséshez telepítsen egy embedding modellt is:

ollama pull nomic-embed-text

Cloud-szolgáltatók hozzáadása​

A cloud-szolgáltatók opcionálisak. Felhasználónkénti kulcsokat a Settings → API keys alatt, szerverre érvényes kulcsokat a backend/.env fájlban adhat meg (majd indítsa újra a backendet), ezután engedélyezze a szolgáltatót:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...

Az alkalmazás frissíti a modelllistákat, ha a szolgáltató támogatja; nem kell nyitva tartani annak dokumentációját.

Az első Work-feladat​

A Work minden feladathoz tartós beszélgetést és külön konténeres fájlrendszert biztosít. Hitelesített rendszergazdák használhatják.

  1. Telepítse és indítsa el a Dockert a backend hostján.
  2. Indítsa a Work elemből az oldalsávon, a lapok + menüjéből, a Home oldalról vagy a Cmd/Ctrl + Shift + U billentyűkkel.
  3. Válasszon eszközhívást támogató modellt.
  4. Írja le a kívánt eredményt, majd válassza a Run lehetőséget.
  5. Kövesse az eredményt a Files, Activity, Git, Terminal és Preview nézetekben.

A feladat az oldalsávban marad. A futás vagy előnézet leállítása megőrzi a munkateret; a törlés végleg eltávolítja.

A Work a telepített Ollamát, Ollama Cloudot vagy beállított chat/completion bővítményt használja. Távoli szolgáltatónál figyelmeztetés jelzi, hogy az megkapja a beszélgetést, az eszközdefiníciókat és a kért eredményeket. Egy önálló futás több számlázott hívást is indíthat.

A futtatási környezetről, tárolásról, hálózatról, előnézetről és biztonságról lásd: Work: elszigetelt munkaterületek.

Docker​

git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d

Hozza létre az első rendszergazdát a böngészőben. Nem kell flag vagy újraindítás; a későbbi nyilvános regisztrációk alapértelmezés szerint zártak.

Ha az Ollama már fut a hoston vagy másik gépen:

docker compose -f docker-compose.external-ollama.yml up -d

NVIDIA GPU-hoz használja a repository GPU Compose-fájlját.

A Compose-fájlok csatlakoztatják a Docker socketet a Work számára, ezzel root szintű irányítást adva az alkalmazásnak a host felett. Olvassa el a Work: elszigetelt munkaterületek útmutatót, Linuxon állítsa be a DOCKER_GID értéket a .env fájlban, és távolítsa el a mountot, ha nem kíván Worköt használni.

A beépített Ollama csak belül érhető el. A -f docker-compose.ollama-host.yml felülírást csak akkor adja hozzá, ha egy másik hostfolyamatnak szüksége van az API-ra; a felülírás loopbackhez köti a portot.

A Home lapon Start, Continue és Explore található. Ugyanezek a célok az oldalsávon és a parancspalettán (Cmd/Ctrl + K) is elérhetők, közelítő kereséssel a beszélgetések, Work és műveletek között, valamint teljes szöveges kereséssel az üzenetekben, jegyzetekben és dokumentumokban.

  • Naptár — felhasználónkénti naptár ismétlődő eseményekkel.
  • Automatizálások — ütemezett AI-futások beszélgetésként.

Billentyűparancsok​

BillentyűparancsMűvelet
Cmd/Ctrl + KParancspaletta
Cmd/Ctrl + Shift + OÚj beszélgetés
Cmd/Ctrl + Shift + UÚj Work-feladat
Cmd/Ctrl + BOldalsáv váltása
Cmd/Ctrl + ,Settings
Cmd/Ctrl + DTéma váltása
?Settings a Shortcuts lapon
EscPárbeszédpanel bezárása
EnterÜzenet küldése
Shift + EnterÚj sor

Következő lépések​