Aller au contenu
QGIS
Dépannage

QGIS Flatpak : corriger « No module named pip »

Publié le Mis à jour le

Exécutez pip via le Flatpak avec --devel, puis installez avec --user. Ces deux options sont nécessaires : --devel remplace le runtime par le SDK, qui contient réellement pip, et --user envoie les fichiers dans un répertoire où le sandbox vous autorise à écrire.

/usr/bin/python3: No module named pip

bwrap: execvp pip3: No such file or directory

ERROR: Could not install packages due to an EnvironmentError:
[Errno 30] Read-only file system: '/usr/lib/python3.11/site-packages/urllib3-1.25.9.dist-info'

error: runtime/org.kde.Sdk/x86_64/5.15-22.08 not installed

Ces quatre lignes proviennent du même sandbox. Vous les rencontrez avec le paquet QGIS de Flathub, org.qgis.qgis, sur n'importe quelle distribution Linux, dès qu'un plugin demande un paquet Python introuvable et que vous utilisez pip comme vous le feriez avec une autre installation.

La correction rapide

  1. Relevez la branche du SDK demandée par votre Flatpak QGIS

    Exécutez flatpak info org.qgis.qgis et cherchez la ligne Sdk:. Elle fournit un nom et une branche, par exemple org.kde.Sdk/x86_64/6.10. Notez la branche. Ne copiez pas le nombre depuis cette page ou depuis votre message d'erreur : la branche change à chaque nouvelle version de QGIS.

  2. Installez cette branche exacte

    flatpak install flathub org.kde.Sdk//6.10, en remplaçant la branche après les deux barres obliques par celle que vous venez de relever. Toute autre branche s'installe correctement et vous laisse quand même sans pip.

  3. Installez le paquet

    flatpak run --devel --command=pip3 org.qgis.qgis install scipy --user

    Remplacez scipy par le paquet demandé par votre plugin. Conservez les deux options pour toutes les installations que vous effectuerez désormais.

Vérifiez que cela fonctionne

Redémarrez QGIS, ouvrez Extensions > Console Python et saisissez import scipy. Si l'invite revient sans rien afficher, c'est le résultat attendu : QGIS lit le dossier dans lequel vous avez installé le paquet et votre plugin le trouvera lui aussi. Un ModuleNotFoundError signifie que les fichiers sont arrivés dans un emplacement que QGIS ne consulte jamais, quel que soit le résultat affiché par pip pendant l'installation.

Correction 2 : les fichiers sont arrivés en dehors du chemin de recherche de QGIS

Affichez le répertoire dans lequel pip a écrit :

flatpak run --command=python3 org.qgis.qgis -c "import site; print(site.getusersitepackages())"

Comparez-le avec sys.path dans la console Python de QGIS. Si ce répertoire n'apparaît pas dans la liste, rien de ce qui y est installé ne pourra jamais être importé, même si pip a signalé une réussite parfaite. Le journal d'installation semble impeccable du début à la fin et le paquet se trouve bien sur le disque, mais en dehors de l'ensemble des dossiers que ce Python lit au démarrage.

Si l'erreur est inchangée, passez à la correction 3.

Correction 3 : le paquet compile des extensions C

Vous obtenez une erreur de compilateur au milieu de l'installation, pas une erreur Python. Le SDK contient un compilateur, mais pas tous les en-têtes de développement, et vous ne pouvez pas lui en fournir un depuis l'extérieur du sandbox. Demandez à pip de refuser une compilation depuis les sources et de prendre à la place une wheel précompilée :

flatpak run --devel --command=pip3 org.qgis.qgis install scipy --user --only-binary=:all:

S'il n'existe aucune wheel pour votre plateforme, cherchez un paquet qui en publie une.

Si l'erreur est inchangée, passez à la correction 4.

Correction 4 : pip3 manque toujours malgré --devel

L'installation du SDK n'a pas abouti. Confirmez la branche avec flatpak list | grep Sdk, puis construisez pip dans le sandbox comme solution de secours :

flatpak run --command=python3 org.qgis.qgis -m ensurepip --upgrade --user

Considérez ceci comme une solution de secours, rien de plus. Aucune source ne la recommande ici et, sans --devel, elle s'exécute avec le runtime Platform plutôt qu'avec le SDK. Revenez ensuite à l'étape 3 de la correction rapide.

Si l'erreur est inchangée, passez à la correction 5.

Correction 5 : vous n'utilisez pas la version Flathub

Vérifiez avec flatpak info org.qgis.qgis. Si cette commande ne renvoie rien, votre QGIS vient d'une autre source et aucune des commandes ci-dessus ne s'applique. QGIS ne fournit aucun paquet Snap officiel, donc une version Snap provient d'un tiers et possède ses propres règles de sandbox. Sous Debian et Ubuntu, installez QGIS depuis le dépôt officiel QGIS plutôt que depuis Flathub. QGIS utilisera alors le Python du système et les dépendances des plugins s'installeront avec un pip classique.

Si l'erreur est inchangée, envoyez-la-moi ; la section ci-dessous indique quoi mettre dans le mail.

Pourquoi cela se produit

Le Flatpak embarque son propre Python, isolé de celui installé par votre distribution. Un paquet ajouté avec le pip du système ou avec apt est donc invisible pour QGIS. Dans le sandbox, /usr est monté en lecture seule. Une commande pip install classique essaie d'y écrire, ce qui produit la ligne [Errno 30] avec le chemin python3.11, tandis que --user envoie les mêmes fichiers vers un répertoire accessible en écriture.

Pip lui-même se trouve dans le SDK, pas dans le runtime que QGIS démarre normalement. Sans --devel, il n'y a aucun pip3 à exécuter, et la plainte vient donc de bwrap plutôt que de Python. De plus, --devel ne fonctionne que si le SDK correspondant est déjà installé sur votre machine, ce que vous indique la dernière ligne du bloc d'erreur.

Notre plugin AI Segmentation détecte un QGIS Flatpak et vous oriente vers le mode Automatique, qui s'exécute sur nos serveurs et n'installe aucun paquet Python sur votre machine.

Toujours bloqué ?

Envoyez-moi trois éléments : la version de votre QGIS Flatpak obtenue avec flatpak info org.qgis.qgis, la commande exacte que vous avez exécutée et l'intégralité de sa sortie, pas uniquement la dernière ligne. L'adresse est . Si le paquet recherché a été demandé par notre plugin AI Segmentation, précisez-le dans le mail, car cela modifie la correction que j'examinerai en premier parmi les cinq proposées ci-dessus.

Questions fréquentes

Une fois les imports fonctionnels, vous pourrez retourner à vos plugins ; les deux nôtres se trouvent sur le hub QGIS AI. Windows connaît sa propre version de ce problème, décrite dans ImportError: DLL load failed while importing _C in QGIS.

Faites-le dans QGIS en le demandant

AI Agent réalise la tâche que vous décrivez, dans votre propre projet QGIS. Gratuit, sans carte bancaire.

Essayer AI Agent gratuitement

À lire ensuite