Version 23.1 par Aurelie Bertrand le 2026/01/30 14:42
Afficher les derniers auteurs
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.
100
101 (((
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 )))
109 )))
110
111 1. Démarrez une nouvelle conversation. Vous devriez voir le modèle LLM dans la liste des modèles et pouvoir converser avec.
112
113 = Création de la fonction DigDash (en tant qu’administrateur) =
114
115 Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
116
117 1. Allez dans le panneau d’administration (en bas à droite).
118 1. Accédez à l’onglet **Fonctions**.
119 1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
120 1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
121 1. Nommez la fonction **DigDash Agent**.
122 1. Saisissez la description **Fonction pour interagir avec DigDash.**
123 1. Cliquez sur **Enregistrer**.
124
125 = Configuration =
126
127 Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
128
129 == Configuration globale de l’outil ==
130
131 1. Allez dans** **l'onglet** Fonctions** du panneau d'administration.
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.
135 1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
136
137 == Configuration utilisateur de l’outil ==
138
139 === Activation de l’outil ===
140
141 1. Démarrez une nouvelle session de chat..
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**.
144
145 === Clé API DigDash ===
146
147 Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
148
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 :
150
151 {{code language="curl"}}
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 }
167 {{/code}}
168
169 Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
170 Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
171
172 (% start="2" %)
173 1. Collez votre clé API DigDash dans la première vanne utilisateur.
174
175 == Configuration de l’interface ==
176
177 1. Ouvrez le menu **Paramètres**.
178 1. Accédez à la section **Interface**.
179 1. Activez les options suivantes :
180 1*. **iframe Sandbox Allow Same Origin**
181 1*. **iframe Sandbox Allow Forms**
182 Ces réglages sont nécessaires pour l’affichage correct des iframes.
183 1*. **Always Collapse Code Blocks**
184
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
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]]