Wiki source code of Guide d'installation d'Open Web UI

Last modified by Aurelie Bertrand on 2026/01/30 14:51

version	line-number	content
8.1	1	{{toc/}}
	2
	3	----
	4
19.1	5	Ce document présente les étapes nécessaires pour installer et configurer Open Web UI.
1.1	6
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
25.1	88	= Ajout d'un modèle LLM dans Openwebui =
22.1	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.
24.1	99	1. Cliquez sur le symbole "Rafraîchir". Un message devrait s'afficher validant la nouvelle connexion.(% class="box infomessage" %)
23.1	100	(((
22.1	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	)))
24.1	106	1. Démarrez une nouvelle conversation. Vous devriez voir le modèle LLM dans la liste des modèles et pouvoir converser avec.
22.1	107
1.1	108	= Création de la fonction DigDash (en tant qu’administrateur) =
	109
4.1	110	Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
	111
3.1	112	1. Allez dans le panneau d’administration (en bas à droite).
	113	1. Accédez à l’onglet Fonctions.
1.1	114	1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
11.1	115	1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
1.1	116	1. Nommez la fonction DigDash Agent.
3.1	117	1. Saisissez la description Fonction pour interagir avec DigDash.
1.1	118	1. Cliquez sur Enregistrer.
	119
	120	= Configuration =
	121
12.1	122	Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
6.1	123
1.1	124	== Configuration globale de l’outil ==
	125
3.1	126	1. Allez dans l'onglet Fonctions du panneau d'administration.
1.1	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.
3.1	130	1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
1.1	131
2.1	132	== Configuration utilisateur de l’outil ==
1.1	133
4.1	134	=== Activation de l’outil ===
1.1	135
3.1	136	1. Démarrez une nouvelle session de chat..
2.1	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.
1.1	139
3.1	140	=== Clé API DigDash ===
1.1	141
6.1	142	Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
1.1	143
4.1	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 :
3.1	145
5.1	146	{{code language="curl"}}
1.1	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	}
3.1	162	{{/code}}
1.1	163
3.1	164	Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
1.1	165	Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
	166
3.1	167	(% start="2" %)
	168	1. Collez votre clé API DigDash dans la première vanne utilisateur.
1.1	169
6.1	170	== Configuration de l’interface ==
1.1	171
3.1	172	1. Ouvrez le menu Paramètres.
9.1	173	1. Accédez à la section Interface.
1.1	174	1. Activez les options suivantes :
9.1	175	1. iframe Sandbox Allow Same Origin*
	176	1. iframe Sandbox Allow Forms*
1.1	177	Ces réglages sont nécessaires pour l’affichage correct des iframes.
9.1	178	1. Always Collapse Code Blocks*
17.1	179
19.1	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
17.1	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]]