Sari la conținutul principal

🖥️ Aplicația desktop

Aplicația desktop Libre WebUI încadrează interfața web într-o fereastră nativă pentru macOS, Windows și Linux. Se conectează la un server Libre WebUI care rulează pe același computer sau la orice server indicat.

Aplicația este dezvoltată în propriul său depozit; instalatoarele pentru fiecare versiune sunt atașate versiunilor GitHub din depozitul principal.

📦 Descărcare și instalare​

Descărcați pachetul pentru platforma dvs. din cea mai recentă versiune:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg sau .zip, ori brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (instalator) sau Libre-WebUI-Desktop-{version}.exe (portabil)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage sau Libre-WebUI-Desktop-{version}-{arch}.deb

Versiunile de dinaintea redenumirii distribuiau aceste resurse cu prefixul Libre-WebUI-Frontend și cu un pachet de aplicație numit Libre WebUI Frontend.app.

macOS blochează aplicația ca fiind deteriorată​

Libre WebUI folosește temporar o semnătură ad-hoc pentru versiunile macOS. Aceasta păstrează pachetul aplicației valid structural, dar nu identifică editorul pentru Apple și nu permite notarizarea. După ce copiați aplicația în Applications, aprobați-o din Configurări sistem → Confidențialitate și securitate → Deschide oricum.

Dacă macOS nu oferă această opțiune, eliminați atributul de carantină numai după ce verificați că aplicația provine din versiunea oficială Libre WebUI:

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

Nu dezactivați Gatekeeper la nivel global. Distribuirea fără întreruperi necesită în continuare un certificat Developer ID Application și notarizare Apple.

🔌 Conectarea la un server​

Aplicația este un client și necesită un server Libre WebUI. La prima pornire, ecranul inițial oferă două opțiuni:

  • Local: aplicația caută un server pe computerul dvs. (portul 3001, valoarea implicită pentru imaginea Docker și npx libre-webui) și se conectează când verificarea stării acestuia răspunde.
  • La distanță: introduceți adresa URL a oricărui server Libre WebUI accesibil, precum un homelab sau o implementare de echipă. Aplicația îl verifică înainte de conectare.

Alegerea este memorată. Pentru a schimba ulterior serverele, folosiți Libre WebUI → Schimbă serverul… din bara de meniu. Dacă un server memorat nu mai răspunde, aplicația revine la ecranul inițial în loc să afișeze o fereastră goală.

Pentru a rula un server local, consultați Pornire rapidă: sunt acceptate Docker Compose, npx libre-webui și Homebrew.

🧰 Work în aplicația desktop​

Pachetul desktop nu include backend-ul, Docker sau un runtime de containere Work. Disponibilitatea Work este determinată de serverul la care se conectează:

  • un backend nativ care poate rula docker info poate crea containere Work și volume denumite limitate la sarcină;
  • implementarea Compose standard din depozit oferă Work cu backend Docker prin montarea socketului Docker al gazdei, în timp ce o implementare personalizată în container fără runtime accesibil raportează Work ca indisponibil;
  • un server Kubernetes oferă Work cu backend Pod/PVC atunci când chart-ul Helm este instalat cu work.enabled=true; și
  • aplicația continuă să accepte Chat când Work nu este disponibil.

Fișierele Work se află pe gazda Docker sau în spațiul de stocare Kubernetes al serverului, nu în aplicația desktop. Previzualizările trec prin proxy-ul semnat cu aceeași origine al Libre WebUI, astfel încât clienții desktop locali și la distanță le pot folosi când proxy-ul invers al serverului păstrează traficul HTTP și WebSocket.

🎨 Integrare desktop​

  • Bară de meniu nativă cu meniuri pentru aplicație, editare, vizualizare, fereastră și ajutor
  • Bară de titlu macOS personalizată (hiddenInset) cu semafoarele în bara laterală
  • Modul întunecat urmează preferința sistemului
  • Linkurile externe se deschid în browserul implicit, niciodată în aplicație
  • Renderer-ul rulează cu izolarea contextului și fără integrare Node

🚧 Limitări​

  • Arhitectură macOS: pachetele macOS actuale acceptă numai Apple Silicon (arm64)
  • Necesită un server: aplicația nu include backend-ul
  • Work depinde de runtime-ul serverului: nu este inclus niciun runtime Docker sau Kubernetes
  • Fără actualizări automate: actualizările necesită descărcarea unui pachet nou

Consultați Work: Spații de lucru izolate pentru detalii de securitate privind runtime-ul, furnizorii, stocarea și previzualizările.