Aula 01 · Ambiente Python: instalar sem bagunçar o computador · IA Intermediário

Nesta aula

Um ambiente organizado evita erros.

Quase todo erro de instalação em IA tem a mesma origem: o computador usa um programa diferente do que você pensa. Aqui você instala o Python do jeito certo e cria uma gaveta para cada projeto. Não precisa saber programar.

Descobrir qual Python responde no seu computador
Criar um ambiente separado para cada projeto
Entender o que a placa de vídeo exige

Qual Python está respondendo

Quando você digita python no terminal, o computador procura esse programa numa lista de pastas. Funciona como a lista de contatos do celular: ele pega o primeiro que achar com esse nome. Se há dois Pythons instalados, o erro vem de o computador escolher o que você não queria.

import sys
print(sys.executable)
print(sys.prefix)
print(sys.base_prefix)

Este script mostra qual programa está respondendo. Se as duas últimas linhas forem iguais, você não está num ambiente separado. Rode-o sempre que algo não funcionar.

Qual versão usar

O Python lança uma versão nova por ano e cada uma recebe correções por um tempo. A 3.10 deixou de ser atualizada em 1 de outubro de 2026, então não use. Em outubro de 2026, a escolha segura é a 3.14. A versão mais nova do dia pode dar problema, porque as bibliotecas precisam publicar um pacote pronto para ela.

Sistema	Como instalar	Cuidado
Windows	python.org; use o comando `py`	Se a loja abrir, ative os aliases de Python
Mac	python.org; use `python3`	Não mexa no Python da Apple
Linux	O que a distribuição traz	Instale só dentro de um ambiente virtual

Ambiente virtual: uma gaveta por projeto

Pense em uma caixa de ferramentas por obra. A casa A usa uma versão de furadeira, a casa B usa outra, e uma caixa não mexe na outra. O ambiente virtual é essa caixa: uma pasta com as bibliotecas de um projeto.

python -m venv .venv
.venv\Scripts\activate        (no Windows)
source .venv/bin/activate     (no Linux e no Mac)

Ativar só coloca a pasta do ambiente na frente da lista de programas. Nada mais. E guarde a lista, não a pasta: o ambiente é descartável. Se mudar de máquina, apague e recrie a partir do requirements.txt.

Use sempre python -m pip em vez de pip sozinho. Assim o pacote vai para o Python que você está usando, e não para outro escondido no computador.

Coisa de profissional

Você nem precisa ativar o ambiente. A documentação do Python explica que basta chamar o Python do ambiente pelo caminho completo, como .venv/bin/python, e que os programas instalados nele também rodam sem ativação. Isso ajuda em tarefas automáticas, como um agendador que roda de madrugada: em vez de depender de um terminal onde alguém ativou o ambiente, você aponta direto para o Python do projeto.

Placa de vídeo em três camadas

A placa faz muitas contas ao mesmo tempo, e a IA gosta disso. Mas há três camadas, e cada uma pode falhar. A placa é o motor. O driver é o tradutor que o sistema instala para falar com o motor. O programa é o pedido que o seu código faz.

Um driver muito antigo faz o programa dizer que não achou a placa. Atualizar o driver costuma não quebrar nada. No Mac com chip da Apple não existe CUDA da NVIDIA, e o PyTorch usa outro caminho, chamado MPS.

Cuidado

Não use sudo pip install nem --break-system-packages. Os dois mexem no Python do sistema e podem quebrar ferramentas do computador. A saída é sempre um ambiente virtual.

Jupyter: o caderno e o motor

O Jupyter é um caderno no navegador em que você roda o código bloco por bloco. Quem faz as contas é o kernel, um programa separado por trás. Fechar a aba não para o kernel. Para zerar tudo, use o menu Kernel e escolha Restart. E lembre: o kernel é um Python específico. Se o caderno usa outro ambiente, ele não acha as bibliotecas do projeto.

Prática · 5 min

Descubra a versão do seu Python: no Windows, py --version; no Mac e no Linux, python3 --version.
Crie uma pasta chamada triagem, entre nela, crie o ambiente com venv, ative-o e rode o script de três linhas.
Instale numpy com python -m pip install numpy e gere a lista com pip freeze.

Entregável: um arquivo "Minha ficha do ambiente", com a versão do Python, o caminho que o script mostrou e a lista de pacotes.

Resumo

O Python que responde é o primeiro que o computador acha. Confira com o script.
Use uma versão que ainda recebe correções. Em outubro de 2026, a 3.14.
Cada projeto tem o seu ambiente. Guarde a lista, não a pasta.
A placa tem três camadas: motor, driver e pedido.

Fontes

Lidas em 30 de outubro de 2026.

Python. venv: Creation of virtual environments: ativação não é obrigatória.
Python. Status of Python versions: fases de suporte e datas de fim de vida.
Python. PEP 668: a regra que bloqueia o pip no Python do Linux.

Quiz da aula

Três situações para aplicar o que viu.

Ambiente Python: instalar sem bagunçar o computador