設定虛擬 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腳本。