Comment installer une bibliothèque en Python : un guide complet étape par étape

Python est l’un des langages de programmation les plus polyvalents et les plus largement adoptés au monde, et une grande partie de sa puissance provient d’un immense écosystème de bibliothèques tierces. Ces bibliothèques fournissent du code prêt à l’emploi et éprouvé qui permet aux développeurs de créer des applications web, d’automatiser des flux de travail, d’effectuer des analyses de données, d’entraîner des modèles d’apprentissage automatique, et bien plus encore — sans réinventer la roue à chaque fois.

Que vous exécutiez des scripts Python sur votre machine locale, dans un environnement VPS Hosting, ou sur un serveur dédié, savoir comment installer, gérer et maintenir des bibliothèques Python est une compétence fondamentale que tout développeur et administrateur système doit maîtriser.

Ce guide vous accompagne à travers chaque étape du processus — de la vérification de votre installation Python à l’utilisation des environnements virtuels et à la gestion des dépendances à grande échelle.

—

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Accès à un terminal (Linux/macOS) ou à l’Invite de commandes / PowerShell (Windows)
• Les permissions suffisantes pour installer des logiciels (ou un environnement virtuel, abordé ci-dessous)
• Une connexion internet active pour télécharger des paquets depuis PyPI

—

Étape 1 : Vérifier que Python est installé

Avant d’installer des bibliothèques, confirmez que Python est disponible sur votre système.

Ouvrez votre terminal ou invite de commandes et exécutez :

python --version

Ou, sur les systèmes où Python 3 est explicitement requis :

python3 --version

Résultat attendu :

Python 3.11.4

Si Python n’est pas installé

• Windows : Téléchargez l’installateur officiel depuis https://www.python.org/downloads/. Lors de l’installation, cochez la case intitulée « Add Python to PATH » — c’est indispensable pour exécuter Python depuis la ligne de commande.
• Ubuntu/Debian Linux :

  sudo apt update && sudo apt install python3

• CentOS/RHEL/AlmaLinux :

  sudo dnf install python3

• macOS (avec Homebrew) :

  brew install python

> Conseil d’administrateur système : Sur les serveurs de production — y compris les Serveurs Dédiés — préférez toujours installer Python via le gestionnaire de paquets de votre distribution pour vous assurer que les correctifs de sécurité sont appliqués automatiquement.

—

Étape 2 : Vérifier que pip est installé

pip est l’installateur de paquets par défaut de Python. Il se connecte au Python Package Index (PyPI) — un dépôt hébergeant des centaines de milliers de bibliothèques open source — et gère automatiquement le téléchargement, la résolution des dépendances et l’installation.

Vérifiez si pip est disponible :

pip --version

Ou :

pip3 --version

Résultat attendu :

pip 23.2.1 from /usr/lib/python3/dist-packages/pip (python 3.11)

Si pip n’est pas installé

Téléchargez et exécutez le script de démarrage officiel :

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

Alternativement, sur Debian/Ubuntu :

sudo apt install python3-pip

Une fois installé, pip est prêt à être utilisé.

—

Étape 3 : Installer une bibliothèque Python avec pip

Avec Python et pip confirmés, vous pouvez installer n’importe quelle bibliothèque depuis PyPI avec une seule commande.

Syntaxe de base :

pip install library_name

Exemple — installation de la bibliothèque HTTP requests :

pip install requests

pip va :

1. Résoudre toutes les dépendances automatiquement
2. Télécharger les paquets requis
3. Tout installer dans votre environnement Python

Vous verrez une sortie similaire à :

Collecting requests
  Downloading requests-2.31.0-py3-none-any.whl (62 kB)
Installing collected packages: urllib3, certifi, charset-normalizer, idna, requests
Successfully installed requests-2.31.0

—

Étape 4 : Vérifier que la bibliothèque a été installée avec succès

Après l’installation, confirmez que la bibliothèque fonctionne correctement en l’important dans le shell interactif Python.

Lancez le shell Python :

python

Puis tentez d’importer la bibliothèque :

import requests
print(requests.__version__)

Résultat attendu :

2.31.0

Si l’importation se termine sans erreurs, l’installation a réussi. Si vous voyez un ModuleNotFoundError, la bibliothèque n’a pas été installée dans l’environnement Python actif — c’est un problème courant lorsque plusieurs versions de Python ou plusieurs environnements coexistent sur le même système.

—

Étape 5 : Installer une version spécifique d’une bibliothèque

Dans les environnements de production, l’épinglage des dépendances est essentiel. Différentes versions d’une bibliothèque peuvent se comporter différemment ou introduire des changements incompatibles. Pour installer une version précise :

pip install library_name==version_number

Exemple :

pip install requests==2.25.1

Vous pouvez également définir des plages de versions :

pip install "requests>=2.25.0,<3.0.0"

Cela installe la dernière version compatible dans la plage spécifiée — utile lorsque vous avez besoin de flexibilité sans risquer des mises à niveau de version majeure.

—

Étape 6 : Mettre à jour une bibliothèque existante

Pour mettre à jour une bibliothèque vers sa dernière version disponible :

pip install --upgrade library_name

Exemple :

pip install --upgrade requests

Pour mettre à jour pip lui-même (recommandé régulièrement) :

pip install --upgrade pip

> Bonne pratique : Sur les environnements d’hébergement partagé ou les VPS avec cPanel, testez toujours les mises à jour dans un environnement virtuel avant de les appliquer en production pour éviter de casser les applications existantes.

—

Étape 7 : Installer plusieurs bibliothèques depuis un fichier requirements.txt

Pour tout projet au-delà d’un simple script, vous devriez suivre vos dépendances dans un fichier requirements.txt. Cela rend votre projet reproductible sur différentes machines, serveurs et membres de l’équipe.

Créer un fichier requirements.txt

Créez un fichier texte brut nommé requirements.txt et listez chaque dépendance avec sa version épinglée :

requests==2.31.0
numpy==1.25.2
pandas==2.0.3
flask==3.0.0
sqlalchemy==2.0.20

Installer toutes les dépendances en une seule fois

pip install -r requirements.txt

pip lit le fichier et installe chaque paquet listé avec la version correcte.

Générer un fichier requirements.txt automatiquement

Si vous souhaitez capturer l’état actuel de votre environnement :

pip freeze > requirements.txt

Cela exporte tous les paquets actuellement installés et leurs versions exactes — idéal pour verrouiller un environnement fonctionnel avant de le déployer sur un serveur.

—

Étape 8 : Utiliser des environnements virtuels pour isoler les dépendances

C’est sans doute la meilleure pratique la plus importante en développement Python. Les environnements virtuels créent des environnements Python isolés pour chaque projet, évitant les conflits de dépendances entre projets et gardant votre installation Python globale propre.

Pourquoi les environnements virtuels sont importants

Imaginez que le Projet A nécessite requests==2.25.1 et que le Projet B nécessite requests==2.31.0. Sans environnements virtuels, une seule version peut exister globalement — ce qui fait planter l’un des projets. Les environnements virtuels résolvent entièrement ce problème.

Étape par étape : Créer et utiliser un environnement virtuel

1. Installer virtualenv (si pas déjà disponible) :

pip install virtualenv

Alternativement, utilisez le module intégré venv (Python 3.3+) :

python -m venv venv

2. Créer un environnement virtuel dans votre répertoire de projet :

virtualenv venv

Cela crée un dossier venv/ contenant un interpréteur Python et pip isolés.

3. Activer l’environnement virtuel :

• Linux/macOS :

  source venv/bin/activate

• Windows (Invite de commandes) :

  venvScriptsactivate

• Windows (PowerShell) :

  venvScriptsActivate.ps1

Une fois activé, l’invite de votre terminal change pour afficher (venv), indiquant que l’environnement isolé est actif.

4. Installer des bibliothèques dans l’environnement virtuel :

pip install requests flask numpy

Tous les paquets sont installés exclusivement dans venv/ — votre installation Python globale n’est pas touchée.

5. Désactiver l’environnement virtuel une fois terminé :

deactivate

> Conseil pro : Ajoutez votre répertoire venv/ à .gitignore pour qu’il ne soit jamais soumis au contrôle de version. Ne soumettez que requirements.txt.

—

Étape 9 : Désinstaller une bibliothèque

Si vous n’avez plus besoin d’une bibliothèque, supprimez-la proprement avec :

pip uninstall library_name

Exemple :

pip uninstall requests

pip vous demandera de confirmer avant de supprimer le paquet. Pour ignorer l’invite de confirmation (utile dans les scripts) :

pip uninstall -y requests

Pour désinstaller tous les paquets listés dans un fichier requirements.txt :

pip uninstall -r requirements.txt -y

—

Bonus : Commandes pip utiles pour la gestion quotidienne

—

Erreurs courantes et comment les corriger

ModuleNotFoundError: No module named 'requests'

Vous avez installé la bibliothèque avec pip mais vous exécutez un interpréteur Python différent. Utilisez python -m pip install requests pour vous assurer que pip installe dans la bonne version de Python.

Erreurs Permission denied sur Linux

Évitez d’utiliser sudo pip install globalement. Utilisez plutôt un environnement virtuel, ou installez uniquement pour l’utilisateur actuel :

pip install --user library_name

Erreurs de certificat SSL lors de l’installation

Cela peut se produire sur des serveurs avec une configuration SSL incorrecte. Assurez-vous que les certificats CA de votre système sont à jour. Si vous gérez votre propre infrastructure de serveurs, envisagez de l’associer à des Certificats SSL correctement émis pour maintenir un environnement sécurisé sur tous les services.

pip introuvable après l’installation de Python sur Windows

Assurez-vous que Python a été ajouté au PATH lors de l’installation. Relancez l’installateur et sélectionnez « Modifier », puis activez l’option PATH.

—

Déployer des applications Python sur un serveur

Si vous développez des applications web basées sur Python, des scripts d’automatisation ou des pipelines de données qui doivent s’exécuter dans un environnement hébergé, le choix de votre infrastructure est très important.

• VPS Hosting vous donne un accès root complet pour installer n’importe quelle version de Python, gérer des environnements virtuels, configurer des services système et déployer des frameworks comme Django, Flask ou FastAPI.
• Serveurs Dédiés sont idéaux pour les charges de travail Python gourmandes en ressources telles que le traitement de données à grande échelle, l’infrastructure de web scraping ou les API à fort trafic.
• GPU Hosting est le bon choix pour les projets d’apprentissage automatique et d’IA qui s’appuient sur des bibliothèques comme TensorFlow, PyTorch ou NumPy accéléré par CUDA.

—

Conclusion

Installer et gérer des bibliothèques Python est une compétence fondamentale qui impacte directement la qualité, la stabilité et la reproductibilité de vos projets. Voici un résumé rapide de ce que nous avons couvert :

1. Vérifier que Python et pip sont installés et accessibles
2. Utiliser pip install pour installer des bibliothèques depuis PyPI
3. Épingler des versions spécifiques pour la stabilité en production
4. Mettre à jour les bibliothèques avec le flag --upgrade
5. Utiliser requirements.txt pour gérer les dépendances du projet de manière déclarative
6. Toujours utiliser des environnements virtuels pour isoler les dépendances du projet
7. Désinstaller proprement avec pip uninstall

En suivant ces pratiques de manière cohérente — que vous développiez en local ou que vous déployiez dans un environnement VPS Hosting — vous créerez des applications Python plus fiables, maintenables et professionnelles.