Přeskočit na hlavní obsah

🖥️ Desktopová aplikace

Desktopová aplikace Libre WebUI zobrazuje webové rozhraní v nativním okně pro macOS, Windows a Linux. Připojuje se k serveru Libre WebUI na stejném počítači nebo k libovolnému zadanému serveru.

Aplikace se vyvíjí ve vlastním repository. Instalační programy každého vydání jsou přiložené k vydáním GitHub hlavního repository.

📦 Stažení a instalace​

Balíček pro svou platformu stáhněte z nejnovějšího vydání:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg nebo .zip, případně brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (instalátor) nebo Libre-WebUI-Desktop-{version}.exe (přenosný)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage nebo Libre-WebUI-Desktop-{version}-{arch}.deb

Vydání před změnou názvu distribuovala tyto soubory s prefixem Libre-WebUI-Frontend a balíčkem Libre WebUI Frontend.app.

macOS blokuje aplikaci jako poškozenou​

Libre WebUI dočasně používá ad hoc podpis pro sestavení macOS. Balíček tak zůstává strukturálně platný, ale Apple neidentifikuje vydavatele a nelze jej notarizovat. Po zkopírování do Applications jej schvalte v Nastavení systému → Soukromí a zabezpečení → Přesto otevřít.

Pokud macOS tuto možnost nenabízí, odstraňte atribut karantény až po ověření, že aplikace pochází z oficiálního vydání Libre WebUI:

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

Gatekeeper globálně nevypínejte. Bezproblémová distribuce stále vyžaduje certifikát Developer ID Application a notarizaci Apple.

🔌 Připojení k serveru​

Aplikace je klient a potřebuje server Libre WebUI. Při prvním spuštění nabízí úvodní obrazovka dvě možnosti:

  • Místní: aplikace hledá server na počítači (port 3001, výchozí pro image Docker a npx libre-webui) a připojí se po odpovědi kontroly stavu.
  • Vzdálený: zadejte URL dostupného serveru Libre WebUI, například domácí laboratoř nebo týmové nasazení. Aplikace jej před připojením ověří.

Volba se uloží. Server později změníte přes Libre WebUI → Přepnout server…. Pokud uložený server přestane odpovídat, aplikace se vrátí na úvodní obrazovku místo prázdného okna.

Místní server spustíte podle Rychlého startu: Docker Compose, npx libre-webui i Homebrew fungují.

🧰 Work v desktopové aplikaci​

Desktopový balíček neobsahuje backend, Docker ani runtime kontejnerů Work. Dostupnost Work určuje server:

  • nativní backend schopný spustit docker info může vytvářet kontejnery Work a pojmenované svazky omezené na úkol;
  • standardní nasazení Compose poskytuje Work na Dockeru připojením socketu hostitele, zatímco vlastní kontejnerové nasazení bez dostupného runtime hlásí nedostupnost;
  • server Kubernetes poskytuje Work na Pod/PVC při instalaci Helm s work.enabled=true;
  • aplikace podporuje Chat i bez Work.

Soubory Work jsou na hostiteli Docker nebo úložišti Kubernetes serveru, nikoli v desktopové aplikaci. Náhledy procházejí podepsanou same-origin proxy Libre WebUI, takže je mohou používat místní i vzdálení klienti, pokud reverse proxy zachovává HTTP a WebSocket provoz.

🎨 Integrace s desktopem​

  • Nativní nabídka aplikace, úprav, zobrazení, oken a nápovědy
  • Vlastní lišta macOS (hiddenInset) s ovládacími tlačítky v postranním panelu
  • Tmavý režim se řídí systémem
  • Externí odkazy se otevírají ve výchozím prohlížeči, nikdy v aplikaci
  • Renderer běží s izolací kontextu a bez integrace Node

🚧 Omezení​

  • Architektura macOS: aktuální balíčky podporují pouze Apple Silicon (arm64)
  • Vyžaduje server: aplikace neobsahuje backend
  • Work závisí na runtime serveru: runtime Docker ani Kubernetes není součástí
  • Žádné automatické aktualizace: aktualizace vyžaduje nový balíček

Work: Izolované pracovní prostory popisuje runtime, poskytovatele, úložiště a preview security details.