Démarrage rapide
Prérequis
| Prérequis | Minimum | Recommandé |
|---|---|---|
| Node.js | 22.22+ | Dernière version LTS |
| RAM | 8 GB | 16 GB+ |
| Disque | 5 GB | 20 GB+ pour les modèles |
| GPU | Facultatif | 8 GB+ de VRAM pour une inférence locale rapide |
| Docker | Facultatif | Requis pour les tâches Work |
Libre WebUI fonctionne avec Ollama sur CPU uniquement, mais les modèles plus petits sont mieux adaptés au CPU. Pour les extensions de fournisseurs cloud, seule la clé API correspondante est nécessaire.
Le chat, les documents, les artefacts et les fonctionnalités adossées à des fournisseurs ne nécessitent pas Docker.
Work, en revanche, l'exige : Docker doit être installé sur la machine qui exécute le serveur Libre WebUI,
et le processus serveur doit être autorisé à l'invoquer. La commande
npx libre-webui n'installe pas Docker. Si Docker est indisponible, le reste de
Libre WebUI continue de fonctionner tandis que Work indique Environnement d'exécution indisponible ;
les commandes du modèle ne sont jamais exécutées directement sur l'hôte comme solution de secours.
Démarrer Libre WebUI
npx libre-webui@latest
Ouvrez http://localhost:8080. Créez le premier compte ;
ce compte devient administrateur. Les inscriptions publiques suivantes restent
désactivées sauf si vous définissez explicitement ENABLE_SIGNUP=true.
Le lanceur fourni conserve les données persistantes dans ~/.libre-webui. Définissez un
DATA_DIR absolu pour choisir un autre emplacement ; les valeurs relatives sont résolues
depuis le répertoire où vous exécutez npx.
Installer Ollama
Installez Ollama, puis téléchargez un petit modèle généraliste :
ollama pull gemma4:12b
D'autres très bons choix sont gemma4:26b (MoE), gemma4:31b (dense) et qwen3.8:27b. Utilisez le gestionnaire de modèles de Libre WebUI pour parcourir les modèles installés, rechercher dans la bibliothèque Ollama en direct et télécharger des modèles sans quitter l'application.
Pour la recherche sémantique dans les documents, installez également un modèle de plongements vectoriels :
ollama pull nomic-embed-text
Ajouter des fournisseurs cloud
Les fournisseurs cloud sont facultatifs. Ajoutez les clés pour chaque utilisateur dans Paramètres → Clés API, ou
pour tout le serveur dans backend/.env (redémarrez ensuite le serveur), puis activez le
fournisseur dans les paramètres :
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
L'application actualise les listes de modèles des fournisseurs lorsque cette fonction est prise en charge. Il n'est pas nécessaire de garder la documentation ouverte pour trouver les derniers noms de modèles.
Démarrer votre première tâche Work
Work associe à chaque tâche une conversation persistante et un système de fichiers distinct adossé à un conteneur. Cette fonctionnalité est accessible aux administrateurs authentifiés.
- Installez et démarrez Docker sur la machine qui exécute le serveur Libre WebUI.
- Démarrez une tâche depuis le bouton Work dans l'en-tête de la barre latérale, le menu
+de la barre d'onglets, la page d'accueil ouCmd/Ctrl + Shift + U. - Choisissez un modèle prenant en charge l'appel d'outils.
- Décrivez ce que vous souhaitez créer ou modifier, puis sélectionnez Exécuter.
- Suivez le résultat dans les onglets Fichiers, Activité, Git, Terminal et Aperçu du volet d'espace de travail.
La tâche reste dans la barre latérale afin que vous puissiez reprendre ultérieurement la même conversation et les mêmes fichiers. Arrêter une exécution ou un aperçu préserve l'espace de travail. Supprimer la tâche supprime définitivement son espace de travail.
Work peut utiliser un modèle Ollama installé, un modèle Ollama Cloud ou une extension configurée de fournisseur de chat ou de complétion. Lorsque vous sélectionnez un fournisseur distant, Libre WebUI affiche une information avant l'exécution : le fournisseur reçoit la conversation, les définitions des outils et tous les résultats d'outils demandés par le modèle. Une exécution autonome peut effectuer plusieurs appels payants au fournisseur.
Consultez Work : espaces de travail isolés pour en savoir plus sur l'environnement d'exécution, la persistance, le réseau, l'aperçu et la sécurité.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Créez le premier administrateur dans le navigateur. Aucun indicateur d'inscription ni redémarrage n'est nécessaire ; les inscriptions publiques suivantes sont fermées par défaut.
Si Ollama s'exécute déjà sur l'hôte ou une autre machine :
docker compose -f docker-compose.external-ollama.yml up -d
Pour l'accélération par GPU NVIDIA, utilisez le fichier Compose pour GPU fourni par le dépôt.
Les fichiers Compose du dépôt montent le socket Docker de l'hôte afin que Work soit disponible lorsque
Docker est installé. Cela accorde à l'application un contrôle de l'hôte équivalent à celui de l'utilisateur root ;
lisez donc d'abord Work : espaces de travail isolés. Sous Linux, définissez
DOCKER_GID dans .env sur le groupe propriétaire du socket. Retirez le montage si
vous ne souhaitez pas utiliser Work.
L'instance Ollama incluse n'est elle aussi accessible qu'en interne. Ajoutez
-f docker-compose.ollama-host.yml uniquement lorsqu'un autre processus de l'hôte doit accéder à son API ;
la substitution se lie par défaut à l'interface de bouclage.
Se repérer dans l'application
L'onglet Accueil comporte trois sections : Démarrer (nouveau chat, chat privé, nouvelle
tâche Work), Continuer (vos conversations et tâches récentes) et Explorer
(Notes, Calendrier, Automatisations, Modèles, Personas, Imagine). Les mêmes
destinations figurent dans la rangée de navigation de la barre latérale et dans la palette de commandes
(Cmd/Ctrl + K), qui effectue une recherche approximative parmi vos chats, tâches Work et actions de
l'application, ainsi qu'une recherche plein texte dans vos messages, notes et documents.
- Calendrier — un calendrier par utilisateur avec des événements récurrents.
- Automatisations — des exécutions d'IA planifiées livrées sous forme de sessions de chat.
Raccourcis clavier
| Raccourci | Action |
|---|---|
Cmd/Ctrl + K | Palette de commandes (fonctionne pendant la saisie) |
Cmd/Ctrl + Shift + O | Nouveau chat |
Cmd/Ctrl + Shift + U | Nouvelle tâche Work |
Cmd/Ctrl + B | Afficher ou masquer la barre latérale |
Cmd/Ctrl + , | Paramètres |
Cmd/Ctrl + D | Changer de thème |
? | Ouvrir les paramètres dans l'onglet Raccourcis |
Esc | Fermer la fenêtre des paramètres |
Enter | Envoyer le message |
Shift + Enter | Nouvelle ligne |