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