Configurar um espaço de trabalho virtual em Python#

Para criar um ambiente virtual Python utilizando venv, certifique-se de que o Python está instalado no seu sistema. Pode descarregar o instalador em python.org. A API WebSocket do AIM requer o Python 3.8 ou posterior.

  • No Windows, certifique-se de que assinala a opção Adicionar Python 3. x ao PATH durante a instalação. Isto pode exigir privilégios de administrador.

  • No macOS e na maioria das distribuições Linux, o Python 3 já vem normalmente pré-instalado, mas ainda assim é uma boa ideia verificar a versão.

1. Create the Virtual Environment#

A partir do diretório raiz do repositório clonado, execute o seguinte comando:

python -m venv venv

2.º Ative o ambiente virtual#

A partir do diretório raiz do repositório clonado, execute o comando adequado para o seu sistema operativo:

Windows#

PowerShell ou Linha de Comandos:

venv\Scripts\activate

Git Bash (MINGW64) - não recomendado:

source venv/Scripts/activate

macOS, Linux e WSL#

source venv/bin/activate

Nota: Para garantir que o seu ambiente virtual é ativado automaticamente, pode adicionar o comando de ativação ao ficheiro de arranque da sua shell (por exemplo, .bashrc, .zshrc).

Verificar ambiente Shell#

Para verificar se o seu ambiente de shell está a utilizar o ambiente virtual correto, inicie uma sessão Python entrando no REPL:

python

Em seguida, execute os seguintes comandos:

import sys
print(sys.prefix)

O resultado deve corresponder ao caminho para o diretório do seu ambiente virtual.

3. Install the Required Packages#

A partir do diretório raiz do repositório clonado, execute o seguinte comando:

pip install -r requirements.txt

No macOS, se encontrar um erro ao instalar pyaudio, instale primeiro a biblioteca portaudio usando Homebrew, depois tente novamente:

brew install portaudio
pip install -r requirements.txt

No Debian/Ubuntu: Instale portaudio19-dev usando o apt e, em seguida, execute novamente pip install -r requirements.txt:

sudo apt install portaudio19-dev
pip install -r requirements.txt

Agora pode executar scripts Python no robô ligado.