Python Instalar

As caixas Experimente do guia rodam Python de verdade no navegador, então você pode estudar as primeiras aulas sem instalar nada. Mas, para escrever os seus próprios programas, guardar os arquivos e rodar quando quiser, você vai querer o Python no seu computador. A boa notícia: no Linux ele quase sempre já vem instalado, e no Windows e no macOS a instalação leva poucos minutos. Nesta aula você vai conferir a sua versão, entender por que o comando python não existe no Ubuntu, instalar as peças que faltam e fazer um teste final.

As saídas de terminal desta aula vêm do computador da Ana, que usa Ubuntu 26.04. O que não deu para rodar lá (os comandos que instalam com sudo, e tudo o que é de Windows e de macOS) está marcado como ilustrativo, conferido na documentação oficial (docs.python.org/3/using).

A ideia: a música e o tocador

Um arquivo de música no celular não toca sozinho: você precisa de um aplicativo de música para tocá-lo. Com o Python é igual. O seu programa (o arquivo .py) é a música; o interpretador Python é o tocador. "Instalar o Python" é instalar o tocador. Depois disso, qualquer programa Python, seu ou de outra pessoa, pode ser "tocado" no seu computador.

Junto com o interpretador vem a biblioteca padrão: centenas de ferramentas prontas (para datas, contas, arquivos, sorteios…). E existem duas peças extras, que no Ubuntu vêm em pacotes separados:

Para as aulas do Nível 1, só o python3 basta. O pip e o venv têm aulas próprias, mais adiante (pip: Instalando Pacotes e Ambientes Virtuais (venv)), mas vale instalar logo, para não esquecer.

1. O Python já está instalado?

Antes de instalar, pergunte ao computador. Abra o terminal (no Ubuntu: Ctrl+Alt+T) e digite:

$ python3 --version
Python 3.14.4

python3

O nome do interpretador do Python 3, como você aprendeu na Introdução.

--version

"Versão": em vez de rodar um programa, mostre a versão e saia. O atalho -V (V maiúsculo) faz o mesmo.

A resposta Python 3.14.4 quer dizer: Python 3, versão 3.14, revisão 4 (as revisões só corrigem defeitos; tudo o que o guia ensina vale para qualquer 3.14.x). O atalho dá a mesma resposta:

$ python3 -V
Python 3.14.4

E onde ele está? O comando which ("qual") mostra o caminho do programa:

$ which python3
/usr/bin/python3
$ ls /usr/bin/python*
/usr/bin/python3
/usr/bin/python3.14                                « o mesmo Python, pelo nome completo

Se apareceu uma versão, o Python já está aí. Se ela for a 3.14 ou mais nova, você tem tudo de que o guia precisa. Se for mais antiga, veja a tabela da próxima seção.

2. Ubuntu e Debian: já vem instalado

O Ubuntu e o Debian usam o Python nos seus próprios programas (você viu um deles na Introdução: a mensagem de "comando não encontrado"). Por isso, o python3 vem em toda instalação. A versão depende da versão do sistema:

O comando python não existe

Muito tutorial na internet manda digitar python, sem o 3. No Ubuntu, a Ana tentou:

$ python --version
Comando 'python' não encontrado, você quis dizer:
  comando 'python3' do deb python3
  comando 'python' do deb python-is-python3

O terminal não achou nenhum programa chamado python, e o Ubuntu (com aquele programa escrito em Python) sugeriu duas saídas. A palavra "deb" quer dizer "pacote" (os pacotes do Ubuntu são arquivos .deb):

• comando 'python3' do deb python3: "existe o comando python3, do pacote python3", que já está instalado. É só usar python3.
• comando 'python' do deb python-is-python3: "existe um pacote chamado python-is-python3" ("python é python3"), que cria o comando python como um apelido do python3.

O apt deixa simular a instalação, sem instalar nada, com -s. Assim dá para ver o que ela faria:

$ apt-get install -s python-is-python3
NOTA: Esta é apenas uma simulação!
      apt-get precisa de privilégios de root para execução real.
      Lembre-se também de que a trava está desativada e,
      portanto, não dependa da relevância para a situação real atual!
Lendo listas de pacotes...
Construindo árvore de dependências...
Lendo informação de estado...
Resolvendo dependências...
Os NOVOS pacotes a seguir serão instalados:
  python-is-python3                                « só um pacote, pequeno
0 pacotes atualizados, 1 pacotes novos instalados, 0 a serem removidos e 0 não atualizados.
Inst python-is-python3 (3.13.3-1+build1 Ubuntu:26.04/resolute [all])
Conf python-is-python3 (3.13.3-1+build1 Ubuntu:26.04/resolute [all])

Para instalar de verdade, o comando seria sudo apt install python-is-python3 (ilustrativo: o sudo pede a sua senha, e a Ana não instalou). Este guia não precisa dele: todas as aulas usam python3, que funciona em qualquer Ubuntu e Debian, sem instalar nada. Quando um tutorial disser python, escreva python3.

3. O pip e o venv

Numa instalação nova do Ubuntu, o python3 vem, mas o pip e o venv não. Eles estão nos pacotes python3-pip e python3-venv. Para instalar os dois de uma vez (ilustrativo; o sudo pede a sua senha):

sudo apt install python3-pip python3-venv

sudo

"Faça como administrador". Instalar programas mexe no sistema, então o Ubuntu pede a sua senha. Enquanto você digita, nada aparece na tela (nem asteriscos): é normal.

apt

O gerenciador de pacotes do Ubuntu e do Debian: a "loja de aplicativos" do terminal.

install

"Instale".

python3-pip python3-venv

Os dois pacotes, separados por espaço.

No computador da Ana, eles já estavam instalados. A simulação mostra isso:

$ apt-get install -s python3-pip python3-venv
NOTA: Esta é apenas uma simulação!
      apt-get precisa de privilégios de root para execução real.
      Lembre-se também de que a trava está desativada e,
      portanto, não dependa da relevância para a situação real atual!
Lendo listas de pacotes...
Construindo árvore de dependências...
Lendo informação de estado...
python3-pip já é a versão mais nova (25.1.1+dfsg-1ubuntu2).      « já instalado
python3-venv já é a versão mais nova (3.14.3-0ubuntu2).           « já instalado
Resolvendo dependências...
0 pacotes atualizados, 0 pacotes novos instalados, 0 a serem removidos e 0 não atualizados.

Para conferir depois de instalar, pergunte a versão do pip. O jeito recomendado é pedir ao próprio Python que rode o módulo pip (-m quer dizer "módulo"):

$ python3 -m pip --version
pip 25.1.1 from /usr/lib/python3/dist-packages/pip (python 3.14)

A resposta diz a versão do pip (25.1.1), onde ele está e, no fim, para qual Python ele instala pacotes: o 3.14. Também dá para listar os pacotes do Python instalados no sistema:

$ apt list --installed 2>/dev/null | grep -E "^python3(-pip|-venv|\.14|-minimal)?/"
python3-minimal/resolute,now 3.14.3-0ubuntu2 amd64 [instalado,automático]
python3-pip/resolute,now 25.1.1+dfsg-1ubuntu2 all [instalado]
python3-venv/resolute,now 3.14.3-0ubuntu2 amd64 [instalado]
python3.14/resolute-updates,resolute-security,now 3.14.4-1ubuntu0.2 amd64 [instalado,automático]
python3/resolute,now 3.14.3-0ubuntu2 amd64 [instalado]

(O grep filtrou a lista enorme, deixando só as linhas que interessam; o 2>/dev/null esconde um aviso do apt. Não se preocupe com esses detalhes do terminal.)

$ apt-cache show python3-full | grep -E "^(Depends|Description)"
Depends: python3 (= 3.14.3-0ubuntu2), python3.14-full (>= 3.14.3), python3-venv (= 3.14.3-0ubuntu2), idle, python3-gdbm, python3-tk
Description-en: Default Python Interpreter with complete class library

4. Um editor para escrever os programas

Um programa Python é um arquivo de texto puro. Qualquer editor de texto serve, menos os de "documento", como o LibreOffice Writer ou o Word: eles gravam fontes, cores e margens junto com o texto, e o Python não entende nada disso. Algumas opções:

Não existe editor "certo". Para as primeiras aulas, o nano ou o Thonny são ótimos. Se for usar o Editor de Texto, o VS Code ou outro, confira nas configurações que a tecla Tab insere 4 espaços (você vai entender o porquê na aula Sintaxe e Indentação).

5. Outras distribuições Linux

No Fedora e no Arch, o Python também costuma vir instalado. Se não vier, o comando é este (ilustrativo: não foi rodado no computador da Ana, que usa Ubuntu):

Em qualquer uma delas, python3 funciona. Por isso o guia usa sempre python3.

6. Windows

O Windows não vem com Python. Desde a versão 3.14, o jeito recomendado pela documentação oficial é o Python install manager ("gerenciador de instalação do Python"): um programa pequeno que instala o Python, cria os comandos no terminal e cuida das atualizações. Tudo nesta seção é ilustrativo (o computador da Ana usa Linux), conferido em docs.python.org/3/using/windows.html.

Instalando o Python install manager

1. Abra a Microsoft Store, procure por "Python install manager" (ou "Python") e clique em Instalar. Outra opção: baixe o instalador do Windows em python.org/downloads e dê dois cliques nele. A documentação diz que as duas versões são idênticas.
2. Abra o Terminal (ou o PowerShell) e digite python. Se nenhum Python estiver instalado ainda, o gerenciador baixa e instala a versão mais recente sozinho e abre o modo interativo.
3. Na primeira instalação, ele pode perguntar se você quer acrescentar uma pasta ao PATH (a lista de pastas onde o Windows procura comandos). É opcional: python e py funcionam de qualquer jeito.

Depois de instalado, você tem estes comandos:

python --version          # mostra a versão do Python padrão
python ola.py             # roda um programa
py list                   # lista os Pythons instalados
py install 3.14           # instala o Python 3.14
py -V:3.14 ola.py         # roda com uma versão específica

O instalador tradicional (está saindo)

Muito tutorial mostra o instalador antigo do python.org, um .exe com a caixinha "Add python.exe to PATH" na primeira tela. Ele ainda existe para o 3.14, mas está obsoleto: a documentação avisa que ele não será mais produzido a partir do Python 3.16. Se usar esse instalador, marque a caixinha do PATH; sem ela, o comando python não funciona no terminal.

7. macOS

O macOS tem uma pegadinha: ele pode até ter um /usr/bin/python3, mas esse Python é da Apple, para as ferramentas de programação dela (o Xcode), costuma ser antigo e incompleto, e a documentação oficial pede que você nunca o modifique nem apague. Instale o seu, por um destes dois caminhos (ilustrativo, conferido em docs.python.org/3/using/mac.html):

Pelo python.org

1. Baixe o instalador do macOS (um arquivo .pkg) em python.org/downloads. O mesmo arquivo serve para Macs com processador Apple (M1, M2…) e Intel.
2. Dê dois cliques e siga as telas. Ele cria a pasta Python 3.14 em Aplicativos, com o editor IDLE.
3. Nessa pasta, dê dois cliques em Install Certificates.command. Ele instala os certificados que o Python usa para acessar sites com https. Sem isso, programas que baixam coisas da internet dão erro.
4. Abra o Terminal e confira com python3 --version. O instalador ajusta o terminal para que o python3 seja o novo, e não o da Apple.

Pelo Homebrew

Quem já usa o Homebrew, o gerenciador de pacotes mais usado no macOS, pode instalar pelo terminal:

brew install python@3.14
python3 --version

Nos dois casos, no macOS o comando é python3, como no Ubuntu. Tudo o que o guia mostra no terminal vale igual lá.

8. O teste final

Com o Python instalado, rode um programinha de teste. Crie um arquivo chamado teste.py com este conteúdo (a aula Rodando um Programa (.py) mostra como criar o arquivo pelo terminal):

import sys
print("Python está funcionando!")
print("Versão:", sys.version_info.major, sys.version_info.minor)

$ python3 teste.py
Python está funcionando!
Versão: 3 14

import sys

"Importe o módulo sys": uma das ferramentas da biblioteca padrão, com informações sobre o próprio Python. Os módulos têm aula própria (Módulos e import).

print("Python está funcionando!")

Mostra a frase na tela.

sys.version_info.major

O número principal da versão: 3.

sys.version_info.minor

O número secundário: 14.

Se apareceram as duas linhas, está tudo pronto. Faça o mesmo teste no editor do guia:

import sys
print("Python está funcionando!")
print("Versão:", sys.version_info.major)

import sys
print("Python está funcionando!")
print("Versão:", sys.version_info.major, sys.version_info.minor)

Formas diferentes de ter o Python

Quando dá errado

$ python --version
Comando 'python' não encontrado, você quis dizer:
  comando 'python3' do deb python3
  comando 'python' do deb python-is-python3

$ Python3 --version
Comando 'Python3' não encontrado, você quis dizer:
  comando 'python3' do deb python3 (3.14.3-0ubuntu2)
  comando 'cython3' do deb cython3 (3.1.6+dfsg-1ubuntu2)
Experimente: apt install <deb name>

$ python3 --vesion
Unknown option: --vesion
usage: python3 [option] ... [-c cmd | -m mod | file | -] [arg] ...
Try `python -h' for more information.

$ python3
Python 3.14.4 (main, Aug 20 2026, 10:41:58) [GCC 15.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> python3 --version
Traceback (most recent call last):
  File "<python-input-0>", line 1, in <module>
    python3 --version
    ^^^^^^^
NameError: name 'python3' is not defined
>>> exit
$ python3 --version
Python 3.14.4

prnt("Python está funcionando!")

$ python3 teste_erro.py
Traceback (most recent call last):
  File "/home/ana/teste_erro.py", line 1, in <module>
    prnt("Python está funcionando!")
    ^^^^
NameError: name 'prnt' is not defined. Did you mean: 'print'?

prnt("Python está funcionando!")

print("Python está funcionando!")

Referência rápida

Exercícios

Resumo

• Instalar o Python é instalar o interpretador, o "tocador" dos seus programas .py. Confira se ele já está aí com python3 --version.
• No Ubuntu e no Debian, o Python já vem (o Ubuntu 26.04 traz o 3.14). O comando é python3; python, sozinho, dá "Comando 'python' não encontrado".
• O pip (instalador de pacotes) e o venv (ambientes virtuais) vêm em python3-pip e python3-venv: sudo apt install python3-pip python3-venv. Nunca use sudo pip install.
• Escreva os programas num editor de texto puro (nano, Thonny, IDLE, VS Code), com Tab valendo 4 espaços.
• No Windows, use o Python install manager (comandos python e py); o instalador .exe antigo está saindo e, se usado, precisa da caixinha do PATH.
• No macOS, instale pelo python.org (e rode o Install Certificates.command) ou pelo Homebrew; o comando é python3.
• Dentro do >>> quem ouve é o Python; os comandos do terminal vão no $.
• Próximo passo: escrever um arquivo e rodá-lo, em Rodando um Programa (.py).