# 安裝用戶端

本章節介紹如何安裝 FIRERPA 配套的 Python 函式庫，如果您用不到 Python，可以跳過此章節。
在開始前，請先確保您的電腦上已安裝 3.6 至 3.12 任意版本的 Python，然後請執行

```bash
pip3 install -U lamda[full]
```

如果以上命令報錯，請執行下面版本的命令。它們的區別是多了一個引號，因為在不同系統或 Python 版本上，可能會被理解為不同意思，所以兩種方法都可以試一下。

```bash
pip3 install -U 'lamda[full]'
```

```{tip}
透過 -i 參數將 PIP 來源設定為您最近的伺服器（如 USTC 源等）會大大提高安裝速度。
```

## 問題排查

安裝完成後，您可以執行命令 `python3 -m lamda.client` 來檢查是否安裝正確。如果出現編碼錯誤 `UnicodeEncodeError: 'ascii' codec can't encode characters in...`，那麼是因為您的路徑中存在中文，gRPC 無法正確處理這種路徑。您可以執行以下程式碼來驗證是否為此問題。

```python
import sys
print (sys.path)
```

```{note}
如果輸出的 `sys.path` 中包含一個或多個中文路徑，那麼在確保沒有問題的情況下，請檢查您的系統環境變數、PYTHONPATH 或其他 PYTHON 相關的環境變數，並從中移除中文路徑。
```

如果出現其他的匯入錯誤 `ImportError`，請執行以下命令強制重新安裝。

```bash
pip3 install -U --force-reinstall 'lamda[full]'
```

```{tip}
如果這些問題仍然存在，我們建議您建立 virtualenv 來使用。
```

```{attention}
安裝完成後，您可能需要使用 pip 更新任何依賴 frida 的第三方函式庫（例如 frida-tools、objection 等），否則之後使用這些工具時可能會出現難以察覺的異常。
```