Modifié par Aurelie Bertrand le 2025/12/18 14:51
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 = Création de la fonction DigDash (en tant qu’administrateur) =
89
90 Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
91
92 1. Allez dans le panneau d’administration (en bas à droite).
93 1. Accédez à l’onglet **Fonctions**.
94 1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
95 1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
96 1. Nommez la fonction **DigDash Agent**.
97 1. Saisissez la description **Fonction pour interagir avec DigDash.**
98 1. Cliquez sur **Enregistrer**.
99
100 = Configuration =
101
102 Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
103
104 == Configuration globale de l’outil ==
105
106 1. Allez dans** **l'onglet** Fonctions** du panneau d'administration.
107 1. Cliquez sur l’icône engrenage de la carte de la fonction DigDash Agent.
108 1. Configurez le serveur MCP (par défaut : [[http:~~/~~/localhost:8086/mcp>>url:http://localhost:8086/mcp]]).
109 Définissez l’URL de base sur l’application web de l’Agent et ajoutez « /mcp » à la fin.
110 1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
111
112 == Configuration utilisateur de l’outil ==
113
114 === Activation de l’outil ===
115
116 1. Démarrez une nouvelle session de chat..
117 1. Cliquez sur **Contrôles de la conversation** (en haut à droite, à côté de votre avatar).
118 1. Allez dans **Vannes> Functions**, puis sélectionnez **DigDash Agent**.
119
120 === Clé API DigDash ===
121
122 Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
123
124 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 :
125
126 {{code language="curl"}}
127 {
128 "targetUser": "<VOTRE NOM D’UTILISATEUR>",
129 "expires": "PT5M",
130 "note": "string",
131 "permissions": {
132 "agent": "rw",
133 "auth": "none",
134 "users": "rw",
135 "license": "none",
136 "system": "none",
137 "events": "none",
138 "sessions": "none",
139 "connections": "none"
140 }
141 }
142 {{/code}}
143
144 Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
145 Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
146
147 (% start="2" %)
148 1. Collez votre clé API DigDash dans la première vanne utilisateur.
149
150 == Configuration de l’interface ==
151
152 1. Ouvrez le menu **Paramètres**.
153 1. Accédez à la section **Interface**.
154 1. Activez les options suivantes :
155 1*. **iframe Sandbox Allow Same Origin**
156 1*. **iframe Sandbox Allow Forms**
157 Ces réglages sont nécessaires pour l’affichage correct des iframes.
158 1*. **Always Collapse Code Blocks**
159
160
161 (% class="wikigeneratedid" %)
162 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.
163
164 = Pour en savoir plus... =
165
166 * [[Guide d'installation de DigDash Agent>>]]
167 * [[Création d'un graphique avec DigDash Agent>>doc:Digdash.Agent.create_chart_Agent.WebHome]]