Pular para o conteúdo principal

🖥️ Aplicativo para desktop

O aplicativo Libre WebUI envolve a interface web em uma janela nativa no macOS, Windows e Linux. Ele se conecta a um servidor Libre WebUI na mesma máquina ou a qualquer servidor indicado.

O aplicativo é desenvolvido em seu próprio repositório; os instaladores de cada versão são anexados aos lançamentos no GitHub do repositório principal.

📦 Baixar e instalar​

Obtenha o pacote da sua plataforma na versão mais recente:

  • 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 (instalador) ou Libre-WebUI-Desktop-{version}.exe (portátil)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage ou Libre-WebUI-Desktop-{version}-{arch}.deb

Antes da mudança de nome, esses arquivos usavam o prefixo Libre-WebUI-Frontend e o pacote de aplicativo se chamava Libre WebUI Frontend.app.

O macOS bloqueia o aplicativo como danificado​

Temporariamente, as compilações macOS usam uma assinatura ad-hoc. Ela mantém a estrutura do pacote válida, mas não identifica o editor para a Apple e não pode ser notarizada. Depois de copiar o aplicativo para Applications, aprove em Ajustes do Sistema → Privacidade e Segurança → Abrir Mesmo Assim.

Se o macOS não oferecer essa opção, remova o atributo de quarentena somente depois de confirmar que o aplicativo veio da versão oficial:

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

Não desative o Gatekeeper globalmente. Uma distribuição transparente ainda exige um certificado Developer ID Application e notarização da Apple.

🔌 Conectar a um servidor​

O aplicativo é um cliente e precisa de um servidor. Na primeira execução, a tela inicial oferece:

  • Local: procura um servidor na máquina (porta 3001, padrão da imagem Docker e de npx libre-webui) e conecta quando a verificação de saúde responde.
  • Remoto: informe a URL de qualquer servidor acessível, como uma implantação doméstica ou de equipe. O aplicativo verifica antes de conectar.

A escolha é lembrada. Para trocar depois, use Libre WebUI → Trocar servidor… na barra de menus. Se o servidor salvo parar de responder, o aplicativo volta à tela inicial em vez de mostrar uma janela vazia.

Para executar localmente, consulte Início rápido. Docker Compose, npx libre-webui e Homebrew são compatíveis.

🧰 Work no aplicativo​

O pacote desktop não inclui backend, Docker nem runtime de contêiner Work. A disponibilidade depende do servidor:

  • um backend nativo que executa docker info pode criar contêineres e volumes nomeados específicos da tarefa;
  • a implantação Compose padrão oferece Work via Docker ao montar o socket do host, enquanto um contêiner personalizado sem runtime acessível informa indisponibilidade;
  • um servidor Kubernetes oferece Work com Pods/PVCs quando o chart Helm está instalado com work.enabled=true; e
  • Chat continua disponível quando Work não está.

Os arquivos Work vivem no host Docker ou armazenamento Kubernetes do servidor, não no aplicativo. As prévias passam pelo proxy assinado de mesma origem, permitindo uso local e remoto quando o proxy reverso preserva HTTP e WebSocket.

🎨 Integração com o desktop​

  • Barra de menus nativa com menus do aplicativo, edição, visualização, janela e ajuda
  • Barra de título personalizada do macOS (hiddenInset) com botões na barra lateral
  • Modo escuro acompanha a preferência do sistema
  • Links externos abrem no navegador padrão, nunca dentro do aplicativo
  • O renderer usa isolamento de contexto e não integra o Node

🚧 Limitações​

  • Arquitetura do macOS: os pacotes atuais suportam somente Apple Silicon (arm64)
  • Exige servidor: não inclui o backend
  • Work depende do runtime do servidor: não inclui Docker nem Kubernetes
  • Sem atualização automática: é preciso baixar um novo pacote

Consulte Work: espaços de trabalho isolados para detalhes de runtime, provedor, armazenamento e segurança da prévia.