Pornire rapidă
Cerințe
| Cerință | Minim | Recomandat |
|---|---|---|
| Node.js | 22.22+ | Cea mai recentă versiune LTS |
| RAM | 8 GB | 16 GB+ |
| Disc | 5 GB | 20 GB+ pentru modele |
| GPU | Opțional | 8 GB+ VRAM pentru inferență locală rapidă |
| Docker | Opțional | Necesar pentru Work |
Libre WebUI funcționează cu Ollama numai pe CPU, dar modelele mai mici sunt mai potrivite. Pentru pluginurile cloud aveți nevoie doar de cheia API corespunzătoare.
Chat-ul, documentele, artefactele și funcțiile furnizorilor nu necesită Docker. Work necesită Docker pe sistemul backend și permisiunea procesului de a-l apela. npx libre-webui nu instalează Docker. Fără Docker, restul aplicației funcționează, iar Work afișează Runtime unavailable; comenzile modelului nu rulează pe host ca soluție de rezervă.
Pornirea Libre WebUI
npx libre-webui@latest
Deschideți http://localhost:8080. Primul cont devine administrator. Înscrierea publică ulterioară rămâne închisă, dacă nu setați ENABLE_SIGNUP=true.
Launcher-ul împachetat păstrează starea persistentă în ~/.libre-webui. Pentru altă locație, setați un DATA_DIR absolut; valorile relative sunt rezolvate pornind din folderul unde rulează npx.
Instalarea Ollama
Instalați Ollama și descărcați un model general mic:
ollama pull gemma4:12b
Alte opțiuni bune sunt gemma4:26b (MoE), gemma4:31b (dense) și qwen3.8:27b. Model Manager afișează modelele instalate, caută în Ollama Library și descarcă modele din aplicație.
Pentru căutare semantică, instalați și un model de embeddings:
ollama pull nomic-embed-text
Adăugarea furnizorilor cloud
Furnizorii cloud sunt opționali. Adăugați chei per utilizator în Settings → API keys sau pentru întregul server în backend/.env (apoi reporniți backend-ul), după care activați furnizorul:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Aplicația actualizează listele de modele când furnizorul permite acest lucru; nu trebuie să păstrați deschisă documentația sa.
Prima sarcină Work
Work oferă fiecărei sarcini o conversație persistentă și un sistem de fișiere separat într-un container. Este disponibil administratorilor autentificați.
- Instalați și porniți Docker pe host-ul backend.
- Porniți din Work în bara laterală, din
+în bara de file, din Home sau cuCmd/Ctrl + Shift + U. - Selectați un model care acceptă apelarea instrumentelor.
- Descrieți rezultatul dorit și alegeți Run.
- Urmăriți rezultatul în Files, Activity, Git, Terminal și Preview.
Sarcina rămâne în bara laterală. Oprirea execuției sau a preview-ului păstrează spațiul; ștergerea îl elimină definitiv.
Work folosește Ollama instalat, Ollama Cloud sau un plugin chat/completion configurat. Pentru un furnizor la distanță este afișată o avertizare că acesta primește conversația, definițiile instrumentelor și rezultatele solicitate. O execuție autonomă poate produce mai multe apeluri facturabile.
Consultați Work: spații izolate pentru detalii despre runtime, stocare, rețea, preview și securitate.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Creați primul administrator în browser. Nu este necesar niciun flag sau restart; următoarele înscrieri publice sunt închise implicit.
Dacă Ollama rulează deja pe host sau pe alt sistem:
docker compose -f docker-compose.external-ollama.yml up -d
Pentru GPU NVIDIA, folosiți fișierul Compose GPU din repository.
Fișierele Compose montează socket-ul Docker pentru Work și oferă aplicației control asupra host-ului echivalent cu root. Citiți Work: spații izolate, setați DOCKER_GID în .env pe Linux și eliminați mount-ul dacă nu doriți Work.
Ollama inclus este accesibil numai intern. Adăugați -f docker-compose.ollama-host.yml numai dacă alt proces de pe host are nevoie de API; suprascrierea leagă portul la loopback.
Navigare
Fila Home conține Start, Continue și Explore. Aceleași destinații se află în bara laterală și în paleta de comenzi (Cmd/Ctrl + K), cu căutare aproximativă în chat-uri, Work și acțiuni, plus căutare integrală în mesaje, notițe și documente.
- Calendar — calendar per utilizator, cu evenimente recurente.
- Automatizări — execuții AI programate, livrate ca chat-uri.
Scurtături de tastatură
| Scurtătură | Acțiune |
|---|---|
Cmd/Ctrl + K | Paleta de comenzi |
Cmd/Ctrl + Shift + O | Chat nou |
Cmd/Ctrl + Shift + U | Sarcină Work nouă |
Cmd/Ctrl + B | Comută bara laterală |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Comută tema |
? | Settings în fila Shortcuts |
Esc | Închide dialogul |
Enter | Trimite mesajul |
Shift + Enter | Linie nouă |