Version 24.1 by Aurelie Bertrand on 2026/01/30 14:43
Show last authors
1 {{toc/}}
2
3 ----
4
5 Ce document présente les étapes nécessaires pour installer et configurer Open Web UI.
6
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
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.(% class="box infomessage" %)
100 (((
101 **ℹ** 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.
102 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//
103 devient //https:~/~/llama-3-3-70b-instruct.endpoints.kepler.ai.cloud.ovh.net/api/openai_compat/v1.//
104 \\De même pour l'api d'OpenAI, //https:~/~/api.openai.com/v1/chat/completions// devient //https:~/~/api.openai.com/v1.//
105 )))
106 1. Démarrez une nouvelle conversation. Vous devriez voir le modèle LLM dans la liste des modèles et pouvoir converser avec.
107
108 = Création de la fonction DigDash (en tant qu’administrateur) =
109
110 Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
111
112 1. Allez dans le panneau d’administration (en bas à droite).
113 1. Accédez à l’onglet **Fonctions**.
114 1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
115 1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
116 1. Nommez la fonction **DigDash Agent**.
117 1. Saisissez la description **Fonction pour interagir avec DigDash.**
118 1. Cliquez sur **Enregistrer**.
119
120 = Configuration =
121
122 Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
123
124 == Configuration globale de l’outil ==
125
126 1. Allez dans** **l'onglet** Fonctions** du panneau d'administration.
127 1. Cliquez sur l’icône engrenage de la carte de la fonction DigDash Agent.
128 1. Configurez le serveur MCP (par défaut : [[http:~~/~~/localhost:8086/mcp>>url:http://localhost:8086/mcp]]).
129 Définissez l’URL de base sur l’application web de l’Agent et ajoutez « /mcp » à la fin.
130 1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
131
132 == Configuration utilisateur de l’outil ==
133
134 === Activation de l’outil ===
135
136 1. Démarrez une nouvelle session de chat..
137 1. Cliquez sur **Contrôles de la conversation** (en haut à droite, à côté de votre avatar).
138 1. Allez dans **Vannes> Functions**, puis sélectionnez **DigDash Agent**.
139
140 === Clé API DigDash ===
141
142 Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
143
144 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 :
145
146 {{code language="curl"}}
147 {
148 "targetUser": "<VOTRE NOM D’UTILISATEUR>",
149 "expires": "PT5M",
150 "note": "string",
151 "permissions": {
152 "agent": "rw",
153 "auth": "none",
154 "users": "rw",
155 "license": "none",
156 "system": "none",
157 "events": "none",
158 "sessions": "none",
159 "connections": "none"
160 }
161 }
162 {{/code}}
163
164 Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
165 Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
166
167 (% start="2" %)
168 1. Collez votre clé API DigDash dans la première vanne utilisateur.
169
170 == Configuration de l’interface ==
171
172 1. Ouvrez le menu **Paramètres**.
173 1. Accédez à la section **Interface**.
174 1. Activez les options suivantes :
175 1*. **iframe Sandbox Allow Same Origin**
176 1*. **iframe Sandbox Allow Forms**
177 Ces réglages sont nécessaires pour l’affichage correct des iframes.
178 1*. **Always Collapse Code Blocks**
179
180 (% class="wikigeneratedid" %)
181 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.
182
183 = Pour en savoir plus... =
184
185 * [[Guide d'installation de DigDash Agent>>]]
186 * [[Création d'un graphique avec DigDash Agent>>doc:Digdash.Agent.create_chart_Agent.WebHome]]