Como instalar OpenCV para Python com Conda

Para instalar OpenCV para Python em um ambiente Conda, use pip, conda ou Anaconda Navigator. O pacote do pip se chama opencv-python, enquanto o módulo importado pelo Python é cv2. Seja qual for o método escolhido, instale o pacote no ambiente em que pretende executar seu código e, em seguida, verifique a importação nesse mesmo ambiente.

Instalar OpenCV com pip em um ambiente Conda

Ative o ambiente Conda que deseja usar antes da instalação, para que pip e Python apontem para o mesmo ambiente. Em um terminal com esse ambiente ativo, execute python -m pip install opencv-python. Usar python -m pip seleciona o pip pelo interpretador Python desse ambiente. O pacote é fornecido pelo projeto opencv-python no PyPI.

Se preferir não ativar o ambiente, execute o Python desse ambiente com -m pip. Evite usar um pip do sistema que não corresponda a ele, pois o pacote pode ser instalado para outro interpretador.

Instalar OpenCV com conda

Com o ambiente de destino ativo, instale o pacote Conda executando conda install opencv. O Conda resolve o pacote e suas dependências para esse ambiente. A disponibilidade pode variar conforme a plataforma e o canal. Se o pacote não estiver disponível no canal padrão, tente o canal conda-forge, mantido pela comunidade, com conda install -c conda-forge opencv (página do pacote). Essa é uma fonte alternativa; isso não garante que ela contenha uma versão mais recente.

Instalar OpenCV com Anaconda Navigator

No Anaconda Navigator, selecione o ambiente em que seu projeto Python será executado. Abra a visualização de pacotes, escolha All se a lista estiver filtrada e pesquise opencv. Selecione o pacote e escolha Apply para revisar e instalar as alterações. O Navigator instala o pacote no ambiente selecionado; escolher outro ambiente altera qual interpretador Python pode importar cv2.

Verificar a instalação do cv2

Execute esta verificação com o interpretador Python do ambiente Conda de destino. Ela informa a versão do módulo importado quando disponível e exibe uma mensagem clara quando esse interpretador não tem o pacote.

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.

A execução fornecida realizou essa verificação e exibiu cv2 is not installed in this Python environment. Essa mensagem permanece em inglês no exemplo. Em um ambiente com OpenCV instalado, a linha de versão exibe a versão instalada do OpenCV. Se a mensagem de pacote ausente aparecer, confira se você selecionou ou ativou o mesmo ambiente usado na instalação. Uma importação bem-sucedida confirma a disponibilidade básica; ela não testa todos os recursos do OpenCV nem configura um projeto de visão computacional.

Escolher um método de instalação

Use pip se quiser instalar o pacote Python pelo interpretador do ambiente de destino. Use conda se quiser que o Conda gerencie o pacote e suas dependências, recorrendo a conda-forge como canal alternativo, se necessário. Escolha Anaconda Navigator se preferir gerenciar pacotes por uma interface gráfica. O método mais adequado depende do seu ambiente e de como você gerencia os pacotes.