pip est l'installateur de packages officiel de Python. Il est fourni avec Python depuis la version 3.4 : dans la grande majorité des cas, vous n'avez rien à installer, il suffit de l'appeler avec python -m pip (ou py -m pip sous Windows). Le bon réflexe se situe ailleurs : installer vos packages dans un environnement virtuel, un par projet.
À quoi sert pip
pip télécharge des bibliothèques depuis le Python Package Index (PyPI), le dépôt public de la communauté Python, puis les installe avec leurs dépendances. La page d'accueil de pypi.org affichait plus de 940 000 projets en novembre 2026. Vous y trouvez pandas pour analyser des données, requests pour appeler une API ou openpyxl pour lire et écrire des fichiers Excel.
Une fois installé, un package s'utilise avec import dans votre script. Si la différence entre module, package et bibliothèque reste floue, l'article sur l'import et l'utilisation d'une bibliothèque Python la détaille.
Vérifier que pip est installé
Ouvrez un terminal (PowerShell ou l'invite de commandes sous Windows, le Terminal sous macOS et Linux) et tapez la commande adaptée à votre système.
py -m pip --version
Cette première forme vaut pour Windows. Sous macOS et Linux, utilisez :
python3 -m pip --version
La réponse donne la version de pip et le chemin du Python auquel il est rattaché. Si plusieurs versions de Python cohabitent sur votre machine, c'est ce chemin qui vous dit où vos packages vont s'installer.
Pourquoi python -m pip plutôt que pip tout court ? La commande pip seule lance le premier pip trouvé dans le PATH, qui n'est pas forcément celui du Python que vous utilisez. Avec -m, pip est lié à l'interpréteur que vous nommez. C'est la forme utilisée par la documentation officielle de Python et par le guide de packaging de la Python Packaging Authority (PyPA).
Installer pip s'il manque
Si la commande répond « No module named pip », commencez par le module standard ensurepip, qui réinstalle la version de pip livrée avec Python :
python3 -m ensurepip --upgrade
Sous Windows, remplacez python3 par py. En dernier recours, la documentation de pip propose le script get-pip.py, à télécharger sur bootstrap.pypa.io puis à lancer avec python get-pip.py. Évitez cette méthode sur le Python fourni par une distribution Linux, qui est géré par le système.
Sur Debian et Ubuntu, pip est d'ailleurs empaqueté à part : sudo apt install python3-pip l'ajoute et python3-venv fournit le module des environnements virtuels. Si Python lui-même n'est pas encore en place, suivez d'abord notre guide pour installer Python et bien configurer son environnement.
Travailler dans un environnement virtuel
Un environnement virtuel est un dossier qui contient sa propre copie de l'interpréteur et ses propres packages. Deux projets peuvent ainsi utiliser deux versions différentes de pandas sans se gêner. On le crée une fois, à la racine du projet :
python3 -m venv .venv
Pour l'activer sous macOS et Linux, tapez source .venv/bin/activate. Sous Windows, lancez .venv\Scripts\activate. Le nom (.venv) apparaît alors devant l'invite, et toute installation atterrit dans ce dossier. venv installe pip automatiquement dans chaque environnement créé.
Sur les systèmes récents, ce n'est plus une simple recommandation. La PEP 668 permet à une distribution de marquer son Python comme géré de l'extérieur : pip refuse alors d'y installer quoi que ce soit hors environnement virtuel et affiche l'erreur externally-managed-environment. L'option --break-system-packages force le passage, et son nom dit bien le risque. Créez plutôt un environnement virtuel.
Les commandes du quotidien
Dans un environnement activé, pip pointe vers le bon Python et vous pouvez l'écrire sans le préfixe python -m.
| Objectif | Commande |
|---|---|
| Installer la dernière version d'un package | pip install requests |
| Installer une version précise | pip install pandas==2.2.3 |
| Mettre à jour un package | pip install --upgrade requests |
| Désinstaller | pip uninstall requests |
| Lister les packages installés | pip list |
| Voir ceux qui ont une version plus récente | pip list --outdated |
| Afficher version, emplacement et dépendances | pip show pandas |
| Repérer des dépendances incompatibles | pip check |
| Figer l'environnement dans un fichier | pip freeze > requirements.txt |
| Réinstaller depuis ce fichier | pip install -r requirements.txt |
Réinstaller un package déjà présent ne change rien : pour passer à une version plus récente, il faut demander --upgrade. Quand vous indiquez une plage de versions (par exemple "requests>=2.31"), mettez-la entre guillemets pour que le terminal ne lise pas le signe > comme une redirection.
Exemple : rendre un projet reproductible
Prenons un script qui fusionne chaque semaine des exports Excel avec pandas. Vous voulez qu'un collègue puisse le lancer sur son poste sans chercher quelles bibliothèques installer.
- Dans le dossier du projet, créez et activez l'environnement :
python3 -m venv .venv, puis la commande d'activation de votre système. - Installez ce dont le script a besoin :
pip install pandas openpyxl. - Vérifiez que le script tourne, puis figez les versions :
pip freeze > requirements.txt. - Partagez le script et le fichier
requirements.txt, sans le dossier.venv. - Votre collègue crée son propre environnement, l'active et lance
pip install -r requirements.txt.
pip freeze liste tout ce qui est installé, dépendances comprises (numpy, par exemple, arrive avec pandas). C'est voulu : le collègue obtient exactement les mêmes versions que vous. Pour la partie analyse, l'article sur l'analyse de données avec pandas prend le relais, et celui sur l'automatisation d'une tâche répétitive en Python montre comment lancer ce type de script sans y penser.
Les erreurs fréquentes et leur solution
« pip n'est pas reconnu en tant que commande interne »
Sous Windows, le dossier des scripts Python n'est pas dans le PATH. Inutile de bricoler les variables d'environnement : py -m pip install ... fonctionne sans, parce que le lanceur py retrouve lui-même vos installations de Python.
ModuleNotFoundError alors que le package est installé
C'est le cas le plus courant. Le package a été installé pour un Python, et le script tourne avec un autre. Comparez le chemin affiché par python -m pip --version avec l'interpréteur choisi dans votre éditeur (dans VS Code, la commande « Python: Select Interpreter »). Installer avec le Python qui exécute le script règle le problème.
error: externally-managed-environment
Vous essayez d'installer dans le Python du système. Créez un environnement virtuel comme plus haut. Pour un outil en ligne de commande que vous voulez utiliser partout, pipx installe chaque application dans son propre environnement.
Permission denied
Ne relancez pas la commande avec sudo : le guide de la PyPA le déconseille explicitement, car cela mélange vos packages avec ceux du système. Travaillez dans un environnement virtuel, ou à défaut utilisez --user, qui installe pour votre seul compte.
Conflit de versions entre deux packages
Deux bibliothèques réclament des versions incompatibles d'une même dépendance. pip check signale le conflit. La solution durable reste un environnement par projet, pour ne jamais mélanger les besoins de deux scripts dans le même Python.
Prochaine étape
Ouvrez un terminal, vérifiez votre pip avec python -m pip --version, créez un environnement dans votre projet en cours et figez-le dans un requirements.txt. Si vous voulez apprendre Python de façon structurée, des bases jusqu'à NumPy et pandas, la formation Python à distance éligible au CPF qui prépare la certification TOSA suit ce chemin avec des séances de visio individuelles.