仮想Pythonワークスペースの設定#

venv使用して Python 仮想環境を作成するには、システムに Python がインストールされていることを確認してください。インストーラーは python.org からダウンロードできます。AIM WebSocket API には Python 3.8 以降が必要です。

  • Windowsの場合、インストール時に「Python 3.xをPATHに追加する」オプションを必ず選択してください。これには管理者権限が必要になる場合があります。

  • macOSやほとんどのLinuxディストリビューションでは、Python 3は通常プリインストールされていますが、バージョンを確認することをお勧めします。

1. Create the Virtual Environment#

クローンリポジトリのルートディレクトリ内で、以下のコマンドを実行してください。

python -m venv venv

2. Activate the Virtual Environment#

クローンリポジトリのルートディレクトリ内で、お使いのオペレーティングシステムに適したコマンドを実行してください。

Windows#

PowerShellまたはコマンドプロンプト:

venv\Scripts\activate

Git Bash (MINGW64) - 非推奨:

source venv/Scripts/activate

macOS、Linux、およびWSL#

source venv/bin/activate

注: 仮想環境が自動的にアクティブ化されるようにするには、シェルの起動ファイル (例: .bashrc、 .zshrc ) にアクティベーション コマンドを追加できます。

シェル環境を確認する#

シェル環境が正しい仮想環境を使用していることを確認するには、REPL を入力して Python セッションを開始します。

python

次に、以下のコマンドを実行します。

import sys
print(sys.prefix)

出力結果は、仮想環境ディレクトリへのパスと一致するはずです。

3. Install the Required Packages#

クローンリポジトリのルートディレクトリ内で、以下を実行します。

pip install -r requirements.txt

macOS で pyaudioインストール中にエラーが発生した場合は、まず Homebrew を使用して portaudio ライブラリをインストールしてから、もう一度試してください。

brew install portaudio
pip install -r requirements.txt

Debian/Ubuntu の場合: apt を使用して portaudio19-dev をインストールし、その後 pip install -r requirements.txt再実行します。

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

You can now run Python scripts on the connected robot.