Konfigurowanie wirtualnego obszaru roboczego Pythona#

Aby utworzyć środowisko wirtualne Pythona za pomocą venv, upewnij się, że Python jest zainstalowany w systemie. Instalator można pobrać ze strony python.org. Interfejs API AIM WebSocket wymaga Pythona w wersji 3.8 lub nowszej.

  • W systemie Windows należy zaznaczyć opcję Dodaj Pythona 3.x do ścieżki PATH podczas instalacji. Może to wymagać uprawnień administratora.

  • W systemach macOS i większości dystrybucji Linuksa Python 3 jest zazwyczaj preinstalowany, ale mimo to warto sprawdzić wersję.

1. Create the Virtual Environment#

Z poziomu katalogu głównego repozytorium klonów uruchom następujące polecenie:

python -m venv venv

2. Activate the Virtual Environment#

Z poziomu katalogu głównego repozytorium klonów uruchom odpowiednie polecenie dla swojego systemu operacyjnego:

Okna#

PowerShell lub wiersz poleceń:

venv\Scripts\activate

Git Bash (MINGW64) - niezalecane:

source venv/Scripts/activate

macOS, Linux i WSL#

source venv/bin/activate

Uwaga: Aby mieć pewność, że środowisko wirtualne zostanie aktywowane automatycznie, możesz dodać polecenie aktywacji do pliku startowego powłoki (np. .bashrc, .zshrc).

Zweryfikuj środowisko powłoki#

Aby sprawdzić, czy środowisko powłoki korzysta z właściwego środowiska wirtualnego, uruchom sesję Pythona, wchodząc do REPL:

python

Następnie uruchom następujące polecenia:

import sys
print(sys.prefix)

Dane wyjściowe powinny odpowiadać ścieżce do katalogu środowiska wirtualnego.

3. Install the Required Packages#

Z poziomu katalogu głównego repozytorium klonów uruchom:

pip install -r requirements.txt

Jeśli na macOS napotkasz błąd podczas instalacji pyaudio, najpierw zainstaluj bibliotekę portaudio przy użyciu Homebrew, a następnie spróbuj ponownie:

brew install portaudio
pip install -r requirements.txt

W systemie Debian/Ubuntu: zainstaluj portaudio19-dev za pomocą apt, a następnie uruchom ponownie pip install -r requirements.txt:

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

Teraz możesz uruchamiać skrypty Pythona na podłączonym robocie.