Skip to content

COMO_COMECAR.md

Latest commit

 

History

History
91 lines (69 loc) · 3.21 KB

COMO_COMECAR.md

File metadata and controls

91 lines (69 loc) · 3.21 KB
Raw

Como comecar - passo a passo

Escolha um dos dois caminhos:

  • Caminho A - No seu computador (VS Code + Python). Recomendado. E o mais parecido com o trabalho de verdade.
  • Caminho B - Google Colab (pelo navegador). Plano B, caso a instalacao trave. Nao precisa instalar nada.

Caminho A - No seu computador (Windows + VS Code)

1. Instale o que precisa (so na primeira vez)

  • Python 3.10 ou mais novo: https://www.python.org/downloads/

    Na primeira tela do instalador, marque "Add Python to PATH". Isso e o passo que mais gente esquece - e sem ele nada funciona.

  • VS Code: https://code.visualstudio.com/
  • Ao abrir o projeto no VS Code, aceite instalar as extensoes recomendadas (Python e Jupyter) - aparece um aviso no canto inferior direito.

2. Abra a pasta do projeto no VS Code

Arquivo > Abrir Pasta... e escolha a pasta curso-pyhon-2.

3. Abra um terminal e rode o preparador

Menu Terminal > Novo Terminal e digite:

.\setup\preparar_ambiente.ps1

Esse comando cria o ambiente, instala as bibliotecas e roda o diagnostico. Se ao final aparecer "Tudo pronto!", pode comecar.

Deu erro de "execution policy" / scripts desativados? Rode isto uma vez (vale so para esta janela) e tente de novo:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Prefere fazer na mao? Tres comandos equivalem ao script:

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

4. Confirme o interpretador do Python

No canto inferior direito do VS Code (ou Ctrl+Shift+P > "Python: Select Interpreter"), escolha o Python que esta dentro de .venv.

5. Cheque quando quiser

Sempre que tiver duvida se o ambiente esta ok:

python setup\preparar_ambiente.py

Ele lista, com ✔ e ✖, o que esta pronto e o que falta.

Caminho B - Google Colab (sem instalar nada)

  1. Acesse https://colab.research.google.com/ e faca login com uma conta Google.
  2. Arquivo > Fazer upload de notebook e envie o notebook da vez (ex.: notebooks/01_planilhas_pandas.ipynb).
  3. Envie tambem os dados: no painel da esquerda, icone de pasta > upload, e suba os arquivos de dados/ que o notebook usar.
  4. As bibliotecas pandas, matplotlib e outras ja vem no Colab. Se faltar alguma, rode numa celula: 
    !pip install reportlab pypdf python-docx openpyxl
  5. Ajuste os caminhos dos arquivos, se preciso (no Colab os dados costumam ficar em /content/).

No Colab voce nao precisa do .venv nem do preparar_ambiente.ps1 - eles sao so para o Caminho A.

Deu problema? Checklist rapido

Sintoma O que fazer
python nao e reconhecido Python nao esta no PATH. Reinstale marcando "Add Python to PATH".
Script .ps1 nao roda Rode Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass.
ModuleNotFoundError Faltou instalar: pip install -r requirements.txt (com o .venv ativo).
Acentos estranhos no terminal Feche e reabra o terminal; o projeto ja configura UTF-8.
Notebook nao acha o .venv Ctrl+Shift+P > "Python: Select Interpreter" > escolha o do .venv.