Antes do workshop

English version

O DotBot Academy é uma introdução prática à programação de um enxame de pequenos robôs com Python. Você trabalha em dupla, primeiro num simulador e depois com robôs de verdade.

O que você precisa saber

  • Python básico: variáveis, laços, chamada de funções.
  • Não é preciso ter experiência com robótica nem com eletrônica.

Seu computador

Você pode usar os Macs do laboratório, que já estão configurados, ou trazer seu próprio computador. As duas opções funcionam. Num Mac do laboratório, o DotBot já está instalado: pule para Já instalou? Atualize. No seu próprio computador, siga os passos 1-4 abaixo antes do workshop; leva poucos minutos e ocupa cerca de 250 MB de disco. A documentação do PyDotBot traz os mesmos passos na seção Install (em inglês).

1. Crie a pasta do workshop

Guarde tudo do workshop numa única pasta chamada dotbot-academy, dentro da sua pasta pessoal: o ambiente virtual, os seus scripts e os arquivos que a gente passar. Crie a pasta e entre nela:

macOS e Linux

mkdir -p ~/dotbot-academy && cd ~/dotbot-academy

Windows (PowerShell)

mkdir -Force ~\dotbot-academy; cd ~\dotbot-academy

2. Instale o Python

Você precisa do Python 3.11, 3.12 ou 3.13; recomendamos o 3.13. O Python 3.14 ainda não funciona, em nenhum sistema: o pygame, de que o DotBot precisa, não instala nele. Veja qual versão você tem com python3 --version (macOS, Linux) ou py --list (Windows).

  • macOS e Windows: baixe “macOS installer” ou “Windows installer (64-bit)” (também para notebooks ARM) na página do Python 3.13.16, e não no botão principal de download do python.org, que traz o 3.14. No Windows, marque “Add python.exe to PATH” na primeira tela do instalador. No macOS, brew install python@3.13 também funciona, se você usa o Homebrew.
  • Linux: use o pacote da sua distribuição (por exemplo sudo apt install python3 python3-venv no Debian ou Ubuntu), desde que seja 3.11, 3.12 ou 3.13.

3. Crie um ambiente virtual e instale o DotBot

Um ambiente virtual mantém os pacotes do workshop separados do resto do sistema. Rode estes comandos num terminal, dentro de dotbot-academy.

macOS e Linux

python3.13 -m venv .venv
source .venv/bin/activate
pip install pydotbot

Sem python3.13? Se python3 --version mostrar 3.11, 3.12 ou 3.13, use python3 -m venv .venv.

Windows (PowerShell)

py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install pydotbot

Os organizadores ainda não testaram o workshop no Windows. Se algo der errado, há Macs do laboratório disponíveis no dia.

Sempre que abrir um terminal novo, volte para a pasta e ative o ambiente antes de usar o dotbot: cd ~/dotbot-academy e depois o segundo comando acima. O prompt passa a começar com (.venv).

4. Confira se funciona

  1. Mostre a versão:

    dotbot --version

    Aparece uma linha como dotbot 0.32.0. Uma mensagem dizendo que nenhum arquivo de configuração foi encontrado é normal.

  2. Inicie o simulador com quatro robôs:

    dotbot run simulator --robots 4

    Abre-se uma aba do navegador com o mapa ao vivo, mostrando quatro robôs simulados.

  3. Aperte Ctrl+C no terminal para parar o simulador.

Se os dois passos funcionarem, está tudo pronto.

Para ir além, dotbot guide mostra no terminal o guia de primeiros passos que vem com o PyDotBot (em inglês): o simulador, como mover um robô, a API REST e o hardware real. Também é um bom contexto para um assistente de IA.

Já instalou? Atualize

Num Mac do laboratório, ou se você já instalou o DotBot antes, atualize, pois pode ter saído uma versão nova:

macOS e Linux

cd ~/dotbot-academy
source .venv/bin/activate
pip install --upgrade pydotbot
dotbot --version

Windows (PowerShell)

cd ~\dotbot-academy
.\.venv\Scripts\Activate.ps1
pip install --upgrade pydotbot
dotbot --version

No dia

  1. Se for usar seu notebook, traga-o carregado e com o carregador.
  2. Os dados do Wi-Fi são informados na sala.
  3. Se não conseguiu terminar a instalação, chegue 10 minutos antes que a gente ajuda, ou use um Mac do laboratório.
  4. Ainda instalando quando a sessão começar? Comece mesmo assim, assim que se sentar: a instalação pode rodar enquanto o instrutor apresenta a plataforma, e você precisa dela para o simulador, a primeira etapa prática.

Problemas comuns

Pedir ajuda a um assistente de IA (ChatGPT, Claude, Gemini ou um agente de programação) é um ótimo primeiro passo: cole a mensagem de erro exata e diga qual sistema operacional você usa. Os casos mais comuns estão abaixo, e a documentação do PyDotBot tem uma página de solução de problemas (em inglês).

pip install pydotbot falha com “Failed to build pygame”. Você está no Python 3.14 (ou 3.10 ou anterior): instale o 3.13 (passo 2), apague a pasta .venv (rm -rf .venv; Windows: Remove-Item -Recurse -Force .venv) e crie-a de novo (passo 3).

dotbot: command not found (ou “não é reconhecido” no Windows). O ambiente virtual não está ativo neste terminal. Rode cd ~/dotbot-academy e depois, de novo, o comando de ativação do passo 3.

O Windows se recusa a rodar Activate.ps1. O PowerShell bloqueia scripts por padrão. Rode Set-ExecutionPolicy -Scope CurrentUser RemoteSigned uma vez e ative de novo.

O simulador para sozinho um segundo depois de iniciar (“Controller stopped”). Provavelmente outro programa, ou um simulador que você não parou, já está usando a porta 8000. Feche-o, ou inicie em outra porta com dotbot run simulator --robots 4 --controller-http-port 8001.

Nenhuma aba do navegador abre. Abra http://localhost:8000/console/ manualmente enquanto o simulador estiver rodando (use o número da sua porta, se você o trocou).

Seu notebook não deixa instalar software (por exemplo, um notebook gerenciado pela empresa). Use um Mac do laboratório no dia; não é preciso instalar nada nele.