Installer Open WebUI et utiliser vos modèles LiteLLM depuis le navigateur

Open WebUI est une interface web gratuite, très proche de ChatGPT, qui fonctionne sur votre propre ordinateur. Vous pouvez y discuter avec n'importe quel modèle d'intelligence artificielle, envoyer des documents, conserver vos conversations et créer des comptes pour d'autres personnes de votre foyer ou de votre équipe.

Dans ce guide, vous allez installer Open WebUI et le relier à LiteLLM, le standard qui réunit tous vos modèles (Ollama, LM Studio, OpenRouter...). Ainsi, depuis un seul écran, vous pourrez choisir n'importe lequel.

Avant de commencer

Pour suivre ce guide, il vous faut LiteLLM installé et démarré, avec sa clé maître sous la main. Si ce n'est pas encore le cas, suivez d'abord notre guide « Installer et configurer LiteLLM pour réunir tous vos modèles d'IA ».

Il vous faut aussi :

• Un ordinateur sous Mac, Windows 10/11 ou Linux.
• Environ 5 Go libres sur le disque.
• Une connexion Internet pour l'installation.

Quelle méthode d'installation choisir

Open WebUI peut s'installer de plusieurs façons. Ce guide en explique deux :

• Avec uv (recommandé pour commencer). Il utilise l'outil que vous avez déjà installé pour LiteLLM. Rien d'autre à installer.
• Avec Docker. Docker est un programme qui exécute des applications dans des « conteneurs » isolés. C'est la méthode habituelle sur les serveurs, mais elle demande d'installer Docker Desktop. Nous l'expliquons à la fin.

Étape 1. Ouvrir le terminal

• Mac : appuyez sur ⌘ + Espace, tapez « Terminal » et appuyez sur Entrée.
• Windows : ouvrez le menu Démarrer, tapez « PowerShell » et appuyez sur Entrée.
• Linux : appuyez sur Ctrl + Alt + T.

Vérifiez que uv est installé :

uv --version

Si un numéro de version s'affiche, continuez. Sinon, installez-le comme expliqué à l'étape 2 du guide LiteLLM.

Étape 2. Installer et démarrer Open WebUI

Avec uv, une seule commande télécharge Open WebUI et le démarre. Nous lui indiquons aussi un dossier fixe (DATA_DIR) pour conserver vos données : conversations, utilisateurs et réglages.

Mac et Linux

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Windows

$env:DATA_DIR="$HOME\.open-webui"; uvx --python 3.11 open-webui@latest serve

La première fois prend plusieurs minutes : il télécharge Open WebUI, une version adaptée de Python et quelques composants servant à lire les documents. De nombreuses lignes défilent dans le terminal. Quand un message comme Application startup complete ou Uvicorn running on http://0.0.0.0:8080 apparaît, c'est prêt.

Étape 3. Créer votre compte administrateur

1. Ouvrez votre navigateur et allez sur :

http://localhost:8080

2. Un écran d'accueil s'affiche (« Get started with Open WebUI »). Cliquez pour commencer.
3. Indiquez votre nom, votre e-mail et un mot de passe, puis cliquez sur Create Admin Account.

Le premier compte créé est celui de l'administrateur. Ensuite, l'inscription de nouveaux comptes se désactive automatiquement : personne d'autre ne pourra créer de compte sans votre autorisation.

Étape 4. Mettre l'interface en français

Si l'interface s'affiche en anglais :

1. Cliquez sur votre nom ou avatar (en bas à gauche) et choisissez Settings.
2. Dans General, cherchez Language et choisissez Français.

Étape 5. Relier Open WebUI à LiteLLM

Avant cette étape, vérifiez que LiteLLM fonctionne dans une autre fenêtre de terminal (avec litellm --config config.yaml dans son dossier).

1. Cliquez sur votre nom ou avatar et ouvrez le Panneau d'administration (Admin Panel).
2. Allez dans Paramètres (Settings), puis Connexions (Connections). Dans certaines versions, le chemin est Settings → Admin → Connections : la section porte le même nom.
3. Dans la partie API OpenAI (Manage OpenAI API Connections), cliquez sur le bouton + pour ajouter une connexion.
4. Remplissez les champs :

• URL : http://localhost:4000/v1
• Clé (API Key) : votre clé maître LiteLLM, celle qui commence par sk-.

5. Cliquez sur Enregistrer (Save).

Open WebUI demande à LiteLLM sa liste de modèles et les ajoute automatiquement. Inutile de les saisir un par un.

Étape 6. Votre première conversation

1. Cliquez sur Nouvelle discussion (New Chat), en haut à gauche.
2. En haut se trouve le sélecteur de modèle. Ouvrez-le : les noms donnés à vos modèles dans LiteLLM apparaissent, par exemple gemma-local, lmstudio-gemma ou qwen-gratuit.
3. Choisissez-en un, écrivez votre message et appuyez sur Entrée.

Vous pouvez changer de modèle à tout moment depuis ce même sélecteur.

Ce que vous pouvez faire d'utile

• Interroger un document : glissez un PDF ou un fichier texte dans la zone de message et posez vos questions sur son contenu.
• Comparer des modèles : dans le sélecteur de modèle, le bouton + ajoute un second modèle à la même conversation. Les deux répondent en même temps et vous pouvez comparer.
• Créer des comptes pour d'autres personnes : depuis Panneau d'administration → Utilisateurs, ajoutez des utilisateurs et choisissez les modèles que chacun peut utiliser.
• Chercher dans vos conversations : elles sont toutes conservées dans la barre latérale et consultables.

Le relancer un autre jour

Open WebUI fonctionne tant que sa fenêtre de terminal est ouverte. Pour l'utiliser un autre jour :

1. Démarrez LiteLLM (et Ollama ou LM Studio si vous les utilisez).
2. Ouvrez un terminal et répétez la commande de l'étape 2. Cette fois, il démarre en quelques secondes.
3. Allez sur http://localhost:8080 et connectez-vous.

Vos conversations et réglages sont toujours là, car ils sont enregistrés dans le dossier .open-webui.

Autre option : l'installer avec Docker

Si vous utilisez déjà Docker, ou si vous voulez qu'Open WebUI démarre avec l'ordinateur, c'est la méthode habituelle.

1. Installez Docker Desktop depuis docker.com (Mac et Windows), ou Docker Engine sur Linux. Sur Windows, Docker Desktop utilise WSL 2 : acceptez son installation s'il la propose.
2. Ouvrez Docker Desktop et attendez qu'il indique être démarré.
3. Dans le terminal, lancez cette commande (sur une seule ligne) :

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=remplacez-par-une-longue-phrase --name open-webui --restart always ghcr.io/open-webui/open-webui:main

4. Attendez une ou deux minutes et allez sur http://localhost:3000.

Deux différences importantes avec l'installation par uv :

• L'adresse est http://localhost:3000 au lieu de http://localhost:8080.
• Dans Docker, « localhost » désigne le conteneur lui-même, pas votre ordinateur. C'est pourquoi, à l'étape 5, l'URL de LiteLLM doit être http://host.docker.internal:4000/v1.

Problèmes fréquents

• Le premier démarrage est très long. C'est normal : il télécharge des composants. Attendez le message de démarrage terminé.
• Le navigateur n'ouvre pas localhost:8080. Vérifiez que la fenêtre du terminal est toujours ouverte et sans erreur. Si le port est occupé, ajoutez --port 8081 à la fin de la commande de l'étape 2 et allez sur http://localhost:8081.
• Aucun modèle n'apparaît dans le sélecteur. Vérifiez que LiteLLM fonctionne et que la clé de la connexion est exactement votre clé maître. Dans Connexions, modifiez la connexion : s'il y a un bouton de vérification, il vous dira si LiteLLM répond.
• Erreur de connexion avec Docker. Utilisez http://host.docker.internal:4000/v1 au lieu de localhost.
• Un modèle apparaît mais échoue en répondant. Le problème se situe entre LiteLLM et ce modèle : vérifiez qu'Ollama ou LM Studio sont ouverts, ou que vous n'avez pas atteint la limite d'un modèle gratuit d'OpenRouter.
• Sur un Mac à puce Apple, le conteneur Docker se fige. Si la variable DOCKER_DEFAULT_PLATFORM=linux/amd64 est définie, ajoutez --platform linux/arm64 à la commande Docker.

Et ensuite

Vous avez maintenant votre propre ChatGPT avec tous vos modèles. Les guides suivants de la série montrent comment utiliser ces mêmes modèles depuis l'éditeur de code Cursor et comment ajouter à Open WebUI le nouveau modèle d'IA intégré à macOS.

Guide suivant: Utiliser Cursor avec les modèles payants d'OpenRouter et les modèles gratuits de LiteLLM