Como usar ambientes virtuais em Python

Usando ambientes virtuais Python com notebooks Jupyter

Se você estiver usando notebooks Jupyter (também conhecidos como notebooks IPython) e já tiver o Jupyter instalado em todo o sistema, crie seu ambiente digital e ative-o. Então, no diretório do seu ambiente digital, execute pip set up ipykernel para adicionar os componentes necessários para IPython. Finalmente, corra ipython kernel set up —person —title=onde project_name é um nome que você deseja associar a esse projeto específico. A partir daí, você poderá iniciar o Jupyter e mudar para o kernel IPython instalado dentro do ambiente digital.

Atualizando ambientes virtuais Python

Quando você atualiza um runtime do Python em seu sistema, os ambientes virtuais que usam essa versão do Python não são atualizados automaticamente. Essa é sua responsabilidade. E isso ocorre intencionalmente, porque atualizações involuntárias para versões do Python podem quebrar seus pacotes correspondentes.

Se você atualizou um interpretador Python existente com um menor atualização pontual — por exemplo, do Python 3.13.1 para o Python 3.13.3 — você pode atualizar qualquer ambiente digital correspondente com bastante facilidade. Em um immediate de comando no diretório do projeto, digite:

python -m venv /path/to/venv --upgrade

Não ative o ambiente digital de antemão, ou a atualização pode não funcionar.

Como alternativa, conforme observado acima (consulte “Removendo o ambiente digital Python”), você pode optar por remover completamente o venv e recriá-lo usando seu arquivo necessities.txt ou pyproject.toml.

Se você instalou um principal nova versão do Python — por exemplo, você já tem o Python 3.10 e agora instala o Python 3.11 junto com ele — você precisará criar um novo ambiente digital que use especificamente a nova versão principal. Não tente atualizar um ambiente digital existente para uma versão mais avançada do Python.