Installer Python Hors Ligne

Ce guide montre comment installer Python sur un serveur mindzieStudio Enterprise qui n’a pas accès à Internet. Vous téléchargez tout sur un ordinateur ayant accès à Internet, copiez un dossier sur le serveur, et installez à partir de ce dossier. Aucune étape sur le serveur ne nécessite une connexion Internet.

Prévoyez environ 30 minutes, plus un redémarrage du serveur à la fin.

Quand Vous Avez Besoin de Python

Python est nécessaire uniquement pour ces fonctionnalités :

Si vous n’utilisez pas ces fonctionnalités, vous n’avez pas besoin d’installer Python.

Vue d’ensemble

Ce Dont Vous Avez Besoin

• Un ordinateur avec accès à Internet qui a Python installé. Il peut fonctionner sous Windows, macOS ou Linux, et toute version récente de Python. Il sert uniquement à télécharger les fichiers.
• Un moyen de copier un dossier sur le serveur, comme une clé USB, un partage de fichiers ou la méthode de transfert approuvée par votre organisation.
• Un accès administrateur sur le serveur mindzieStudio.
• Au moins 500 Mo d’espace disque libre sur le serveur.

Choisir une Version de Python

Utilisez Python 3.13 (64 bits). Ce guide utilise Python 3.13 dans tous les exemples.

Partie 1 : Sur l’Ordinateur avec Accès Internet

Étape 1 : Créer le Dossier Hors Ligne

Créez un dossier nommé python-offline avec un sous-dossier packages à l’intérieur. Dans PowerShell :

New-Item -ItemType Directory -Force -Path C:\python-offline\packages

Tout ce que vous téléchargez ira dans ce seul dossier.

Étape 2 : Télécharger l’Installateur Python

1. Allez sur la page Python Releases for Windows
2. Trouvez la version la plus récente de Python 3.13
3. Cliquez sur Windows installer (64-bit). Le fichier s’appelle par exemple python-3.13.15-amd64.exe
4. Enregistrez le fichier dans C:\python-offline

Étape 3 : Lister les Paquets Dont Vous Avez Besoin

Créez un fichier texte nommé requirements.txt dans C:\python-offline, avec un nom de paquet par ligne.

Incluez toujours pandas et numpy. Chaque enrichissement Python et action Script Python en a besoin. Ajoutez requests si vos scripts appellent des web services ou vos propres APIs d’entreprise.

pandas
numpy
requests

Ajoutez ensuite une ligne pour chaque autre paquet utilisé par vos scripts. Regardez les lignes import dans votre code Python. Certains paquets s’installent sous un nom différent de celui importé :

python -m pip freeze > requirements.txt

Étape 4 : Télécharger les Paquets

Ouvrez PowerShell et lancez :

cd C:\python-offline
python -m pip download -r requirements.txt -d packages --only-binary=:all: --platform win_amd64 --python-version 3.13

Signification de chaque option :

Grâce à ces options, l’ordinateur de téléchargement n’a pas besoin de Windows ni de la même version de Python que le serveur.

La commande se termine par Successfully downloaded suivi des noms des paquets. Le dossier packages contient maintenant des fichiers .whl tels que pandas-3.0.5-cp313-cp313-win_amd64.whl. Le cp313 montre que les fichiers sont construits pour Python 3.13.

Étape 5 : Copier le Dossier sur le Serveur

Copiez tout le dossier python-offline sur le serveur. Ce guide suppose que vous le copiez dans C:\python-offline sur le serveur.

Le dossier doit ressembler à ceci :

C:\python-offline\
    python-3.13.15-amd64.exe
    requirements.txt
    packages\
        numpy-2.5.3-cp313-cp313-win_amd64.whl
        pandas-3.0.5-cp313-cp313-win_amd64.whl
        requests-2.34.2-py3-none-any.whl
        ... et plus de fichiers .whl

Vos numéros de version peuvent différer.

Partie 2 : Sur le Serveur mindzieStudio

Étape 6 : Installer Python pour Tous les Utilisateurs

mindzieStudio s’exécute sous son propre compte Windows, pas sous votre compte. Il peut utiliser uniquement Python installé pour tous les utilisateurs et ajouté au PATH système.

Installez Python via la fenêtre de l’installateur ou une commande PowerShell unique.

Option A : Fenêtre d’installateur

1. Cliquez droit sur python-3.13.15-amd64.exe et choisissez Exécuter en tant qu’administrateur
2. Sur le premier écran, cochez Add python.exe to PATH, puis cliquez sur Customize installation
3. Sur l’écran Optional Features, assurez-vous que pip est coché, puis cliquez sur Next
4. Sur l’écran Advanced Options :
   • Cochez Install Python 3.13 for all users. Le chemin d’installation change en C:\Program Files\Python313
   • Assurez-vous que Add Python to environment variables est coché
   • Laissez décochées toutes les options commençant par Download. Ces options nécessitent une connexion Internet
5. Cliquez sur Install, puis sur Close à la fin de l’installation

Option B : Commande PowerShell

Ouvrez PowerShell en tant qu’administrateur et lancez la commande suivante. Remplacez le nom de fichier par celui de votre installateur.

Start-Process -FilePath "C:\python-offline\python-3.13.15-amd64.exe" -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0" -Wait

InstallAllUsers=1 installe Python pour tous les utilisateurs. PrependPath=1 ajoute Python au PATH système. La commande ne montre aucune fenêtre et se termine quand l’installation est terminée.

Étape 7 : Vérifier l’Installation de Python

Fermez toutes les fenêtres PowerShell ouvertes. Ouvrez une nouvelle fenêtre PowerShell en tant qu’administrateur. Une nouvelle fenêtre est nécessaire pour prendre en compte le PATH actualisé.

Exécutez :

python --version
where.exe python

Sortie attendue :

Python 3.13.15
C:\Program Files\Python313\python.exe

Étape 8 : Installer les Paquets depuis le Dossier

Dans la même fenêtre PowerShell en Administrateur, lancez :

python -m pip install --no-index --find-links C:\python-offline\packages -r C:\python-offline\requirements.txt

--no-index indique à pip de ne pas aller sur Internet. --find-links indique à pip d’installer depuis votre dossier packages.

La commande se termine par Successfully installed suivi des noms des paquets.

Vérifiez que les paquets se chargent :

python -c "import pandas, numpy; print('pandas', pandas.__version__, 'numpy', numpy.__version__)"

Sortie attendue (vos numéros de version peuvent différer) :

pandas 3.0.5 numpy 2.5.3

Étape 9 : Redémarrer le Serveur

Redémarrez le serveur Windows.

mindzieStudio vérifie Python au démarrage et doit voir le PATH système actualisé. Redémarrer le serveur est la méthode fiable pour s’en assurer. Recycler le pool d’applications mindzieStudio n’est pas suffisant.

Étape 10 : Vérifier Python dans mindzieStudio

Vérifiez l’outil de Configuration Enterprise

1. Ouvrez l’outil Configuration Enterprise sur le serveur
2. Allez à l’onglet Server Setup
3. Dans la section Python, le Statut doit afficher Installed avec votre version de Python, par exemple Installed (3.13.15)

Lancez un enrichissement test

1. Ouvrez un projet dans mindzieStudio et allez à un notebook d’enrichissement
2. Ajoutez un bloc d’enrichissement Python
3. Vérifiez que Python Image est réglé sur LOCAL
4. Entrez ce code. Ajoutez une ligne import pour chaque autre paquet installé :

import pandas
import numpy

5. Calculez l’enrichissement. Il se termine sans erreur Python.

Ajouter des Paquets Plus Tard

Pour ajouter un paquet après l’installation initiale, répétez les mêmes étapes avec seulement le nouveau paquet :

1. Sur l’ordinateur avec accès Internet, ajoutez le paquet à requirements.txt puis relancez la commande de l’Étape 4, avec la même option --python-version
2. Copiez le dossier packages mis à jour et requirements.txt sur le serveur
3. Sur le serveur, lancez à nouveau la commande de l’Étape 8 dans une fenêtre PowerShell en Administrateur

Vous n’avez pas besoin de redémarrer le serveur après avoir ajouté des paquets.

Résolution des Problèmes

"Python executable 'python' was not found"

Symptôme : Un enrichissement Python ou une action Script Python échoue avec :

Python executable 'python' was not found. Please ensure Python is installed and added to your system PATH environment variable.

Solution :

1. Reprenez l’Étape 7. where.exe python doit pointer vers C:\Program Files\Python313\python.exe
2. Si Python a été installé uniquement pour votre compte, réinstallez-le pour tous les utilisateurs (Étape 6)
3. Redémarrez le serveur (Étape 9)

"ModuleNotFoundError: No module named ..."

Symptôme : Un enrichissement Python ou une action Script Python échoue avec ModuleNotFoundError: No module named 'openpyxl' (ou un autre paquet).

Solution :

1. Dans une fenêtre PowerShell Administrateur, lancez python -m pip show openpyxl (utilisez le nom du paquet de l’Étape 3)
2. Si pip indique Package(s) not found, le paquet n’est pas installé. Téléchargez-le (Étape 4), copiez-le sur le serveur et installez-le (Étape 8)
3. Si la ligne Location pointe vers un dossier sous C:\Users\, le paquet a été installé sans droits administrateur. Lancez python -m pip uninstall openpyxl, puis répétez l’Étape 8 en Administrateur

"No matching distribution found" lors du téléchargement

Symptôme : La commande de l’Étape 4 échoue avec ERROR: No matching distribution found for suivi d’un nom de paquet.

Solution :

• Vérifiez l’orthographe. Utilisez le nom du paquet, pas le nom d’importation (voir le tableau à l’Étape 3)
• Si la ligne inclut un numéro de version, cette version peut ne pas être disponible pour votre version de Python. Supprimez le numéro, ou choisissez une version plus récente
• Si votre requirements.txt provient de pip freeze, supprimez toute ligne contenant @ file:. Ces paquets ont été installés localement et ne peuvent pas être téléchargés

"Could not find a version that satisfies the requirement" sur le serveur

Symptôme : La commande de l’Étape 8 échoue avec Could not find a version that satisfies the requirement suivi d’un nom de paquet.

Solution :

• Le dossier packages ne contient pas ce paquet, ou les fichiers ont été téléchargés pour une autre version de Python
• Comparez python --version sur le serveur avec la partie cp des noms des fichiers. Pour Python 3.13, les fichiers doivent inclure cp313 (les fichiers finissant par py3-none-any.whl fonctionnent pour toutes les versions)
• Téléchargez à nouveau sur l’ordinateur avec Internet, avec --python-version correspondant au serveur, puis recopiez le dossier packages

Python Image affiche "Python not configured"

Symptôme : Un enrichissement Python, une action Script Python, ou un enrichissement Prédiction de Cas IA affiche Python not configured dans le réglage Python Image.

Solution : Les enrichissements et actions créés avant l’installation de Python gardent cette valeur. Changez Python Image en LOCAL et recalculer.

Documentation Associée

• Installer Python - Installer Python sur un serveur avec accès Internet
• Enrichissement Python - Transformations de données personnalisées avec Python
• Action Script Python - Exécution automatisée de scripts Python
• Prédiction de Cas IA - Prédictions avec apprentissage automatique
• Exigences techniques - Exigences serveur