HOWTO · Python

Cómo instalar OpenCV en Python con Conda

Instala OpenCV para Python en un entorno de Conda con pip, conda o Anaconda Navigator, y comprueba que el entorno puede importar cv2.

En esta página

Para instalar OpenCV para Python en un entorno de Conda, puedes usar pip, conda o Anaconda Navigator. El paquete de pip se llama opencv-python, mientras que en Python se importa como cv2. Elijas el método que elijas, instala el paquete en el entorno donde ejecutarás el código y comprueba allí la importación.

Instalar OpenCV con pip en un entorno de Conda

Activa el entorno de Conda que quieras usar antes de instalar el paquete, para que pip y Python apunten al mismo entorno. Abre una terminal con ese entorno activo y ejecuta python -m pip install opencv-python. Al usar python -m pip, se invoca pip mediante el intérprete de Python de ese entorno. El paquete lo distribuye el proyecto opencv-python en PyPI.

Si prefieres no activar el entorno, ejecuta el intérprete de Python de ese entorno con -m pip. Evita usar un pip del sistema que no corresponda: podría instalar el paquete para otro intérprete.

Instalar OpenCV con conda

Con el entorno de destino activo, instala el paquete de Conda con conda install opencv. Conda resuelve el paquete y sus dependencias para ese entorno. La disponibilidad puede variar según la plataforma y el canal. Si el paquete no está disponible en el canal predeterminado, prueba el canal comunitario conda-forge con conda install -c conda-forge opencv (página del paquete). Es una fuente alternativa, pero eso no garantiza que incluya una versión más reciente.

Instalar OpenCV con Anaconda Navigator

En Anaconda Navigator, selecciona el entorno donde se ejecutará tu proyecto de Python. Abre la vista de paquetes, elige All si la lista está filtrada y busca opencv. Selecciona el paquete y pulsa Apply para revisar e instalar los cambios. Navigator instala el paquete en el entorno seleccionado; si eliges otro, cambiará el intérprete de Python que puede importar cv2.

Verificar la instalación de cv2

Ejecuta esta comprobación con el intérprete de Python del entorno de Conda de destino. Muestra la versión del módulo importado, si está disponible, y un mensaje claro si el paquete no está instalado para ese intérprete.

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.

En la ejecución proporcionada, la comprobación se ejecutó y mostró cv2 is not installed in this Python environment. Esa etiqueta permanece en inglés porque el bloque de salida es inmutable. En un entorno donde OpenCV esté instalado, la línea de versión muestra la versión instalada. Si aparece el mensaje de que falta el paquete, comprueba que hayas seleccionado o activado el mismo entorno en el que lo instalaste. Una importación correcta confirma que el paquete está disponible en lo básico; no comprueba todas las funciones de OpenCV ni configura un proyecto de visión artificial.

Elegir un método de instalación

Usa pip si quieres instalar el paquete de Python mediante el intérprete del entorno de destino. Usa conda si quieres que Conda gestione el paquete y sus dependencias; si lo necesitas, conda-forge es un canal alternativo. Elige Anaconda Navigator si prefieres gestionar paquetes mediante una interfaz gráfica. El método adecuado depende de tu entorno y de cómo administres sus paquetes.