HOWTO · Python

OpenCV mit Python und Conda installieren

Installieren Sie OpenCV für Python in einer Conda-Umgebung mit pip, conda oder Anaconda Navigator und prüfen Sie anschließend, ob die Umgebung cv2 importieren kann.

Auf dieser Seite

Um OpenCV für Python in einer Conda-Umgebung zu installieren, können Sie pip, conda oder Anaconda Navigator verwenden. Das pip-Paket heißt opencv-python, während Python es als cv2 importiert. Installieren Sie das Paket in der Umgebung, in der Sie Ihren Code ausführen möchten, und prüfen Sie anschließend dort den Import.

OpenCV mit pip in einer Conda-Umgebung installieren

Aktivieren Sie vor der Installation die gewünschte Conda-Umgebung, damit pip und Python dieselbe Umgebung verwenden. Führen Sie in einem Terminal mit aktiver Umgebung den Befehl python -m pip install opencv-python aus. Mit python -m pip wird pip über den Python-Interpreter dieser Umgebung aufgerufen. Das Paket wird vom opencv-python-Projekt auf PyPI bereitgestellt.

Wenn Sie die Umgebung nicht aktivieren möchten, können Sie stattdessen deren Python-Programmdatei mit -m pip aufrufen. Verwenden Sie kein systemweites pip, das nicht zu dieser Umgebung gehört, da es das Paket möglicherweise für einen anderen Interpreter installiert.

OpenCV mit conda installieren

Aktivieren Sie die Zielumgebung und installieren Sie das Conda-Paket mit conda install opencv. Conda löst das Paket und seine Abhängigkeiten für diese Umgebung auf. Welche Pakete verfügbar sind, kann je nach Plattform und Channel variieren. Falls das Paket im Standard-Channel nicht verfügbar ist, können Sie den von der Community gepflegten Channel conda-forge mit conda install -c conda-forge opencv ausprobieren (Paketübersicht). Das ist eine alternative Quelle und keine Garantie für eine neuere Version.

OpenCV mit Anaconda Navigator installieren

Wählen Sie in Anaconda Navigator die Umgebung aus, in der Ihr Python-Projekt ausgeführt werden soll. Öffnen Sie die Paketansicht, wählen Sie All, falls die Paketliste gefiltert ist, und suchen Sie nach opencv. Markieren Sie das Paket und wählen Sie Apply, um die Änderungen zu prüfen und die Installation zu starten. Navigator installiert das Paket in der ausgewählten Umgebung. Wenn Sie eine andere Umgebung auswählen, ändert sich damit auch, welcher Python-Interpreter cv2 importieren kann.

Die cv2-Installation überprüfen

Führen Sie diese Prüfung mit dem Python-Interpreter der Conda-Zielumgebung aus. Wenn das Modul verfügbar ist, wird seine Version angezeigt. Andernfalls erscheint eine verständliche Meldung.

import importlib.util

if importlib.util.find_spec("cv2") is None:
    print("cv2 is not installed in this Python environment.")
else:
    import cv2
    print(cv2.__version__)
cv2 is not installed in this Python environment.

Der bereitgestellte Lauf hat diese Prüfung ausgeführt und die Meldung cv2 is not installed in this Python environment. ausgegeben. Dieser unveränderte Beispieltext bleibt auf Englisch. In einer Umgebung mit installiertem OpenCV zeigt die Versionszeile die installierte OpenCV-Version an. Wenn die Meldung zum fehlenden Paket erscheint, prüfen Sie, ob Sie dieselbe Umgebung ausgewählt oder aktiviert haben, in der Sie die Installation vorgenommen haben. Ein erfolgreicher Import bestätigt die grundlegende Verfügbarkeit; er prüft weder alle OpenCV-Funktionen noch richtet er ein Computer-Vision-Projekt ein.

Eine Installationsmethode auswählen

Verwenden Sie pip, wenn Sie das Python-Paket über den Interpreter der Zielumgebung installieren möchten. Verwenden Sie conda, wenn Conda das Paket und seine Abhängigkeiten verwalten soll; bei Bedarf steht conda-forge als alternativer Channel zur Verfügung. Anaconda Navigator eignet sich, wenn Sie Pakete lieber über eine grafische Oberfläche verwalten. Welche Methode passt, hängt von Ihrer Umgebung und davon ab, wie Sie Ihre Pakete verwalten.