設定虛擬 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#

在複製倉庫的根目錄下,執行適用於您作業系統的相應命令:

視窗#

PowerShell 或命令提示字元:

venv\Scripts\activate

Git Bash (MINGW64) - 不建議使用:

source venv/Scripts/activate

macOS、Linux 和 WSL#

source venv/bin/activate

注意: 為確保您的虛擬環境自動激活,您可以將激活命令添加到 shell 的啟動文件中(例如, .bashrc, .zshrc)。

驗證 Shell 環境#

若要驗證您的 shell 環境是否使用了正確的虛擬環境,請透過輸入 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

現在您可以在連接的機器人上執行Python腳本。