Version 23.1 by Aurelie Bertrand on 2026/01/30 14:42
Hide last authors
Aurelie Bertrand 8.1 1 {{toc/}}
2
3 ----
4
Aurelie Bertrand 19.1 5 Ce document présente les étapes nécessaires pour installer et configurer Open Web UI.
Aurelie Bertrand 1.1 6
Aurelie Bertrand 18.1 7 = Installation d’OpenWebUI =
8
9 == Pré-requis ==
10
11 * Serveur Linux (Ubuntu/Debian recommandé)
12 * Python 3.11
13 * //pip// et //virtualenv//
14
15 Installez les packages requis :
16
17 {{code}}
18 sudo apt update
19 sudo apt install -y python3 python3-venv python3-pip build-essential
20 {{/code}}
21
22 == Installation ==
23
24 1. Créez l'utilisateur openwebui:(((
25 {{code}}
26 sudo useradd -m -s /bin/bash openwebui
27 {{/code}}
28 )))
29
30 (% start="2" %)
31 1. Dirigez-vous vers le dossier d'installation: (((
32 {{code}}
33 cd /home/openwebui
34 {{/code}}
35 )))
36 1. (((
37 Créez et activez un environnement virtuel dans ce dossier:
38
39 (((
40 {{code language="shell"}}
41 python3 -m venv openwebui-venv
42 source openwebui-venv/bin/activate
43 {{/code}}
44 )))
45 )))
46 1. (((
47 Mettez à jour pip pour éviter les problèmes de compatibilité :
48
49 (((
50 {{code}}
51 pip install --upgrade pip
52 {{/code}}
53 )))
54 )))
55
56 (% start="5" %)
57 1. (((
58 Installez le package open-webui:
59
60 (((
61 {{code}}
62 pip install open-webui
63 {{/code}}
64
65 Notez que le téléchargement peut durer plusieurs minutes.
66
67 (% class="box warningmessage" %)
68 (((
69 ⚠ Ne pas utiliser le package Python uv.
70 L’agent DigDash (fonction OpenWebUI) nécessite l’installation de bibliothèques Python supplémentaires à l’exécution, ce qui n’est pas compatible avec uv.
71 )))
72 )))
73 )))
74
75 (% start="6" %)
76 1. (((
77 (((
78 Déployez le serveur:
79
80 {{code}}
81 nohup open-webui serve --port 5000 &
82 {{/code}}
83
84 L’interface web devrait être disponible sur http:~/~/localhost:5000.
85 )))
86 )))
87
Aurelie Bertrand 22.1 88 = Ajouter un modèle LLM dans Openwebui =
89
90 1. Connectez-vous à http:~/~/localhost:5000 en tant qu'administrateur.
91 1. Cliquez sur votre nom d'utilisateur en bas en gauche, puis cliquez sur **Panneau d'adminstration**.
92 1. Cliquez ensuite sur l'onglet **Réglages** en haut de la page.
93 1. Enfin dans le menu, cliquez sur **Connexions**.
94 1. Cliquez sur le bouton **+** pour ajouter une nouvelle connexion.
95 1. Vous pouvez renseigner une API compatible OpenAI. Nous allons ajouter le modèle LLama 3.3 d'OVH:
96 1*. **Type de connexion**: Externe
97 1*. **URL**: [[https:~~/~~/llama-3-3-70b-instruct.endpoints.kepler.ai.cloud.ovh.net/api/openai_compat/v1>>url:https://llama-3-3-70b-instruct.endpoints.kepler.ai.cloud.ovh.net/api/openai_compat/v1]]
98 1*. **Clé**: La clé d'API du modèle. Vous pouvez réutiliser la clé OVH de l'agent DigDash.
99 1. Cliquez sur le symbole "Rafraîchir". Un message devrait s'afficher validant la nouvelle connexion.
100
Aurelie Bertrand 23.1 101 (((
Aurelie Bertrand 22.1 102 (% class="box infomessage" %)
103 (((
104 **ℹ** En cas d'échec, assurez-vous que la clé d'API est bien correcte. En général, l'url attendue est la racine du web-service de completion de chat.
105 Par exemple, le webservice complet d'OVH //https:~/~/llama-3-3-70b-instruct.endpoints.kepler.ai.cloud.ovh.net/api/openai_compat/v1/chat/completions//
106 devient //https:~/~/llama-3-3-70b-instruct.endpoints.kepler.ai.cloud.ovh.net/api/openai_compat/v1.//
107 \\De même pour l'api d'OpenAI, //https:~/~/api.openai.com/v1/chat/completions// devient //https:~/~/api.openai.com/v1.//
108 )))
Aurelie Bertrand 23.1 109 )))
Aurelie Bertrand 22.1 110
Aurelie Bertrand 23.1 111 1. Démarrez une nouvelle conversation. Vous devriez voir le modèle LLM dans la liste des modèles et pouvoir converser avec.
Aurelie Bertrand 22.1 112
Aurelie Bertrand 1.1 113 = Création de la fonction DigDash (en tant qu’administrateur) =
114
Aurelie Bertrand 4.1 115 Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
116
Aurelie Bertrand 3.1 117 1. Allez dans le panneau d’administration (en bas à droite).
118 1. Accédez à l’onglet **Fonctions**.
Aurelie Bertrand 1.1 119 1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
Aurelie Bertrand 11.1 120 1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
Aurelie Bertrand 1.1 121 1. Nommez la fonction **DigDash Agent**.
Aurelie Bertrand 3.1 122 1. Saisissez la description **Fonction pour interagir avec DigDash.**
Aurelie Bertrand 1.1 123 1. Cliquez sur **Enregistrer**.
124
125 = Configuration =
126
Aurelie Bertrand 12.1 127 Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
Aurelie Bertrand 6.1 128
Aurelie Bertrand 1.1 129 == Configuration globale de l’outil ==
130
Aurelie Bertrand 3.1 131 1. Allez dans** **l'onglet** Fonctions** du panneau d'administration.
Aurelie Bertrand 1.1 132 1. Cliquez sur l’icône engrenage de la carte de la fonction DigDash Agent.
133 1. Configurez le serveur MCP (par défaut : [[http:~~/~~/localhost:8086/mcp>>url:http://localhost:8086/mcp]]).
134 Définissez l’URL de base sur l’application web de l’Agent et ajoutez « /mcp » à la fin.
Aurelie Bertrand 3.1 135 1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
Aurelie Bertrand 1.1 136
Aurelie Bertrand 2.1 137 == Configuration utilisateur de l’outil ==
Aurelie Bertrand 1.1 138
Aurelie Bertrand 4.1 139 === Activation de l’outil ===
Aurelie Bertrand 1.1 140
Aurelie Bertrand 3.1 141 1. Démarrez une nouvelle session de chat..
Aurelie Bertrand 2.1 142 1. Cliquez sur **Contrôles de la conversation** (en haut à droite, à côté de votre avatar).
143 1. Allez dans **Vannes> Functions**, puis sélectionnez **DigDash Agent**.
Aurelie Bertrand 1.1 144
Aurelie Bertrand 3.1 145 === Clé API DigDash ===
Aurelie Bertrand 1.1 146
Aurelie Bertrand 6.1 147 Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
Aurelie Bertrand 1.1 148
Aurelie Bertrand 4.1 149 1. Suivez les instructions du paragraphe [[S'authentifier via ApiKeyAuth>>doc:Digdash.API.DD_API.WebHome||anchor="ApiKeyAuth"]] et définissez les éléments de requête suivants :
Aurelie Bertrand 3.1 150
Aurelie Bertrand 5.1 151 {{code language="curl"}}
Aurelie Bertrand 1.1 152 {
153 "targetUser": "<VOTRE NOM D’UTILISATEUR>",
154 "expires": "PT5M",
155 "note": "string",
156 "permissions": {
157 "agent": "rw",
158 "auth": "none",
159 "users": "rw",
160 "license": "none",
161 "system": "none",
162 "events": "none",
163 "sessions": "none",
164 "connections": "none"
165 }
166 }
Aurelie Bertrand 3.1 167 {{/code}}
Aurelie Bertrand 1.1 168
Aurelie Bertrand 3.1 169 Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
Aurelie Bertrand 1.1 170 Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
171
Aurelie Bertrand 3.1 172 (% start="2" %)
173 1. Collez votre clé API DigDash dans la première vanne utilisateur.
Aurelie Bertrand 1.1 174
Aurelie Bertrand 6.1 175 == Configuration de l’interface ==
Aurelie Bertrand 1.1 176
Aurelie Bertrand 3.1 177 1. Ouvrez le menu **Paramètres**.
Aurelie Bertrand 9.1 178 1. Accédez à la section **Interface**.
Aurelie Bertrand 1.1 179 1. Activez les options suivantes :
Aurelie Bertrand 9.1 180 1*. **iframe Sandbox Allow Same Origin**
181 1*. **iframe Sandbox Allow Forms**
Aurelie Bertrand 1.1 182 Ces réglages sont nécessaires pour l’affichage correct des iframes.
Aurelie Bertrand 9.1 183 1*. **Always Collapse Code Blocks**
Aurelie Bertrand 17.1 184
Aurelie Bertrand 19.1 185 (% class="wikigeneratedid" %)
186 Une fois DigDash Agent et Open Web UI installés et configurés, vous pouvez générer vos premiers graphiques. Consultez la page [[Création d'un graphique avec DigDash Agent>>doc:Digdash.Agent.create_chart_Agent.WebHome]] pour plus de détails.
187
Aurelie Bertrand 17.1 188 = Pour en savoir plus... =
189
190 * [[Guide d'installation de DigDash Agent>>]]
191 * [[Création d'un graphique avec DigDash Agent>>doc:Digdash.Agent.create_chart_Agent.WebHome]]