Aller au contenu principal

🖥️ Application de bureau

L’application de bureau Libre WebUI intègre l’interface web dans une fenêtre native pour macOS, Windows et Linux. Elle se connecte à un serveur Libre WebUI exécuté sur le même ordinateur ou à tout autre serveur que vous indiquez.

L’application est développée dans son propre dépôt. Les programmes d’installation de chaque version sont joints aux versions GitHub du dépôt principal.

📦 Téléchargement et installation​

Téléchargez le paquet correspondant à votre plateforme depuis la dernière version :

  • macOS (Apple Silicon) : Libre-WebUI-Desktop-{version}-mac-arm64.dmg ou .zip, ou brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows : Libre-WebUI-Desktop-Setup-{version}.exe (programme d’installation) ou Libre-WebUI-Desktop-{version}.exe (version portable)
  • Linux : Libre-WebUI-Desktop-{version}.AppImage ou Libre-WebUI-Desktop-{version}-{arch}.deb

Avant le changement de nom, ces ressources étaient publiées avec le préfixe Libre-WebUI-Frontend et l’ensemble applicatif s’appelait Libre WebUI Frontend.app.

macOS indique que l’application est endommagée​

Libre WebUI utilise temporairement une signature ad hoc pour les versions macOS. Cette signature garantit la validité structurelle de l’ensemble applicatif, mais n’identifie pas l’éditeur auprès d’Apple et ne permet pas la notarisation. Après avoir copié l’application dans Applications, autorisez-la depuis Réglages Système → Confidentialité et sécurité → Ouvrir quand même.

Si macOS ne propose pas cette option, supprimez l’attribut de quarantaine uniquement après avoir vérifié que l’application provient de la version officielle de Libre WebUI :

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

Ne désactivez pas Gatekeeper globalement. Une distribution transparente nécessite toujours un certificat Developer ID Application et la notarisation d’Apple.

🔌 Connexion à un serveur​

L’application est un client ; elle a besoin d’un serveur Libre WebUI. Lors du premier lancement, un écran d’accueil propose deux possibilités :

  • Local : l’application recherche un serveur sur votre ordinateur (port 3001, valeur par défaut de l’image Docker et de npx libre-webui) et s’y connecte lorsque son contrôle d’intégrité répond.
  • Distant : saisissez l’URL de tout serveur Libre WebUI accessible, par exemple un laboratoire domestique ou un déploiement d’équipe. L’application le vérifie avant de se connecter.

Votre choix est mémorisé. Pour changer de serveur ultérieurement, utilisez Libre WebUI → Changer de serveur… dans la barre de menus. Si un serveur mémorisé ne répond plus, l’application revient à l’écran d’accueil au lieu d’afficher une fenêtre vide.

Pour exécuter un serveur local, consultez le Démarrage rapide : Docker Compose, npx libre-webui et Homebrew sont tous compatibles.

🧰 Work dans l’application de bureau​

Le paquet de bureau n’inclut ni le serveur dorsal, ni Docker, ni environnement d’exécution de conteneurs Work. La disponibilité de Work dépend du serveur auquel l’application se connecte :

  • un serveur dorsal natif capable d’exécuter docker info peut créer des conteneurs Work et des volumes nommés propres à chaque tâche ;
  • le déploiement Compose standard du dépôt fournit Work avec Docker en montant le socket Docker de l’hôte, tandis qu’un déploiement de conteneur personnalisé sans environnement d’exécution accessible signale que Work est indisponible ;
  • un serveur Kubernetes fournit Work avec des pods et PVC lorsque le chart Helm est installé avec work.enabled=true ;
  • l’application continue à prendre en charge Chat lorsque Work est indisponible.

Les fichiers Work résident sur l’hôte Docker ou le stockage Kubernetes du serveur, et non dans l’application de bureau. Les aperçus transitent par le proxy signé de même origine de Libre WebUI ; les clients de bureau locaux et distants peuvent donc les utiliser lorsque le proxy inverse du serveur préserve le trafic HTTP et WebSocket.

🎨 Intégration au bureau​

  • Barre de menus native avec les menus application, édition, affichage, fenêtre et aide
  • Barre de titre macOS personnalisée (hiddenInset) avec les boutons de fenêtre dans la barre latérale
  • Mode sombre conforme aux préférences du système
  • Ouverture des liens externes dans votre navigateur par défaut, jamais dans l’application
  • Processus de rendu exécuté avec isolation du contexte et sans intégration de Node

🚧 Limites​

  • Architecture macOS : les paquets macOS actuels prennent uniquement en charge Apple Silicon (arm64)
  • Serveur requis : l’application n’inclut pas le serveur dorsal
  • Work dépend de l’environnement d’exécution du serveur : aucun environnement d’exécution Docker ou Kubernetes n’est inclus
  • Absence de mise à jour automatique : les mises à jour nécessitent le téléchargement d’un nouveau paquet

Consultez Work : espaces de travail isolés pour en savoir plus sur l’environnement d’exécution, les fournisseurs, le stockage et la sécurité des aperçus.