# 安装客户端

本章节介绍如何安装 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 等，否则后期使用这些工具的时候可能会出现难以察觉的异常。
```