Início rápido
Requisitos
| Requisito | Mínimo | Recomendado |
|---|---|---|
| Node.js | 22.22+ | LTS mais recente |
| RAM | 8 GB | 16 GB+ |
| Disco | 5 GB | 20 GB+ para modelos |
| GPU | Opcional | 8 GB+ de VRAM para inferência local rápida |
| Docker | Opcional | Obrigatório para tarefas do Work |
O Libre WebUI funciona com o Ollama apenas em CPU, mas modelos menores são mais adequados à CPU. Para plugins de provedores em nuvem, você só precisa da chave de API correspondente.
Chat, documentos, artifacts e recursos fornecidos por provedores não exigem Docker.
O Work exige: o Docker precisa estar instalado na máquina que executa o backend do Libre WebUI,
e o processo do backend deve ter permissão para chamá-lo. O comando
npx libre-webui não instala o Docker. Se o Docker não estiver disponível, o
restante do Libre WebUI continuará funcionando, enquanto o Work informará Ambiente de execução indisponível;
os comandos do modelo nunca serão executados diretamente no host como alternativa.
Inicie o Libre WebUI
npx libre-webui@latest
Abra http://localhost:8080. Crie a primeira conta;
ela se tornará a conta de administrador. Os cadastros públicos posteriores permanecem
desativados, a menos que você defina explicitamente ENABLE_SIGNUP=true.
O inicializador distribuído mantém o estado persistente em ~/.libre-webui. Defina um
DATA_DIR absoluto para escolher outro local; valores relativos são resolvidos
a partir do diretório no qual você executa npx.
Instale o Ollama
Instale o Ollama e baixe um modelo geral pequeno:
ollama pull gemma4:12b
Outras boas opções são gemma4:26b (MoE), gemma4:31b (dense) e qwen3.8:27b. Use o Gerenciador de modelos do Libre WebUI para navegar pelos modelos instalados, pesquisar a biblioteca ativa do Ollama e baixar modelos sem sair do aplicativo.
Para a busca semântica em documentos, instale também um modelo de embedding:
ollama pull nomic-embed-text
Adicione provedores em nuvem
Os provedores em nuvem são opcionais. Adicione chaves por usuário em Configurações → Chaves de API ou
para todo o servidor em backend/.env (reinicie o backend depois) e, em seguida, ative o
provedor nas Configurações:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
As listas de modelos dos provedores são atualizadas pelo aplicativo quando há suporte. Você não precisa manter a documentação aberta para encontrar os nomes de modelos mais recentes.
Inicie sua primeira tarefa do Work
O Work fornece a cada tarefa uma conversa persistente e um sistema de arquivos separado, baseado em contêiner. Ele está disponível para administradores autenticados.
- Instale e inicie o Docker na máquina que executa o backend do Libre WebUI.
- Inicie uma tarefa pelo botão Work no cabeçalho da barra lateral, pelo menu
+da barra de abas, pela página inicial ou comCmd/Ctrl + Shift + U. - Escolha um modelo com suporte a chamadas de ferramentas.
- Descreva o que você quer criar ou alterar e selecione Executar.
- Acompanhe o resultado nas abas Arquivos, Atividade, Git, Terminal e Visualização do painel do espaço de trabalho.
A tarefa permanece na barra lateral, permitindo que você retorne à mesma conversa e aos arquivos depois. Interromper uma execução ou visualização preserva o espaço de trabalho. Excluir a tarefa exclui permanentemente seu espaço de trabalho.
O Work pode usar um modelo Ollama instalado, um modelo Ollama Cloud ou um plugin configurado de provedor de chat ou conclusão. Quando você seleciona um provedor remoto, o Libre WebUI mostra um aviso antes da execução: o provedor recebe a conversa, as definições de ferramentas e quaisquer resultados de ferramentas solicitados pelo modelo. Uma execução autônoma pode fazer várias chamadas pagas ao provedor.
Consulte Work: espaços de trabalho isolados para obter detalhes sobre ambiente de execução, persistência, rede, visualização e segurança.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Crie o primeiro administrador no navegador. Nenhuma flag de cadastro ou reinicialização é necessária; os cadastros públicos seguintes são fechados por padrão.
Se o Ollama já estiver em execução no host ou em outra máquina:
docker compose -f docker-compose.external-ollama.yml up -d
Para aceleração com GPU NVIDIA, use o arquivo Compose de GPU fornecido pelo repositório.
Os arquivos Compose do repositório montam o socket Docker do host para disponibilizar o Work quando
o Docker está instalado. Isso concede ao aplicativo controle equivalente ao root do
host; portanto, leia primeiro Work: espaços de trabalho isolados. No Linux, defina
DOCKER_GID em .env como o grupo proprietário do socket. Remova a montagem se
o Work não for desejado.
O Ollama incluído também é somente interno. Adicione
-f docker-compose.ollama-host.yml apenas quando outro processo do host precisar de sua API;
a substituição vincula ao loopback por padrão.
Conheça a interface
A aba Início tem três seções: Iniciar (nova conversa, conversa anônima, nova
tarefa do Work), Continuar (suas conversas e tarefas recentes) e Explorar
(Notas, Calendário, Automações, Modelos, Personas, Imagine). Os mesmos
destinos ficam na linha de navegação da barra lateral e na paleta de comandos
(Cmd/Ctrl + K), que usa busca aproximada nas suas conversas, tarefas do Work e ações
do aplicativo, além de pesquisa de texto completo no conteúdo de mensagens, notas e documentos.
- Calendário — um calendário por usuário com eventos recorrentes.
- Automações — execuções de IA agendadas e entregues como sessões de chat.
Atalhos de teclado
| Atalho | Ação |
|---|---|
Cmd/Ctrl + K | Paleta de comandos (funciona durante a digitação) |
Cmd/Ctrl + Shift + O | Nova conversa |
Cmd/Ctrl + Shift + U | Nova tarefa do Work |
Cmd/Ctrl + B | Alternar barra lateral |
Cmd/Ctrl + , | Configurações |
Cmd/Ctrl + D | Alternar tema |
? | Abrir Configurações na aba Atalhos |
Esc | Fechar o modal de configurações |
Enter | Enviar mensagem |
Shift + Enter | Nova linha |