Einrichten eines virtuellen Python-Arbeitsbereichs#

Um eine virtuelle Python-Umgebung mit venvzu erstellen, stellen Sie sicher, dass Python auf Ihrem System installiert ist. Sie können das Installationsprogramm von python.org herunterladen. Die AIM WebSocket API erfordert Python 3.8 oder höher.

  • Unter Windows müssen Sie während der Installation unbedingt die Option Python 3.x zum PATH hinzufügen aktivieren. Hierfür sind möglicherweise Administratorrechte erforderlich.

  • Auf macOS und den meisten Linux-Distributionen ist Python 3 in der Regel vorinstalliert, es ist aber trotzdem ratsam, die Version zu überprüfen.

1. Create the Virtual Environment#

Führen Sie im Stammverzeichnis des geklonten Repositorys folgenden Befehl aus:

python -m venv venv

2. Activate the Virtual Environment#

Führen Sie im Stammverzeichnis des geklonten Repositorys den für Ihr Betriebssystem geeigneten Befehl aus:

Windows#

PowerShell oder Eingabeaufforderung:

venv\Scripts\activate

Git Bash (MINGW64) - nicht empfohlen:

source venv/Scripts/activate

macOS, Linux und WSL#

source venv/bin/activate

Hinweis: Um sicherzustellen, dass Ihre virtuelle Umgebung automatisch aktiviert wird, können Sie den Aktivierungsbefehl zur Startdatei Ihrer Shell hinzufügen (z. B. .bashrc, .zshrc).

Shell-Umgebung überprüfen#

Um zu überprüfen, ob Ihre Shell-Umgebung die richtige virtuelle Umgebung verwendet, starten Sie eine Python-Sitzung, indem Sie die REPL eingeben:

python

Führen Sie anschließend die folgenden Befehle aus:

import sys
print(sys.prefix)

Die Ausgabe sollte dem Pfad zu Ihrem virtuellen Umgebungsverzeichnis entsprechen.

3. Install the Required Packages#

Führen Sie im Stammverzeichnis des geklonten Repositorys folgenden Befehl aus:

pip install -r requirements.txt

On macOS, if you encounter an error while installing pyaudio, first install the portaudio library using Homebrew, then try again:

brew install portaudio
pip install -r requirements.txt

Auf Debian/Ubuntu: Installieren Sie portaudio19-dev mit apt und führen Sie dann pip install -r requirements.txt erneut aus:

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

Sie können jetzt Python-Skripte auf dem verbundenen Roboter ausführen.