# Installing the Client

This chapter describes how to install the Python client library **lamda** that accompanies FIRERPA. Before you begin, ensure that Python version 3.6 to 3.13 is installed on your computer, then run the following command:

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

If the above command throws an error, try the version below. The only difference is the added single quotes, because on different systems or Python versions, the command may be interpreted differently. So you can try both methods.

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

```{tip}
You can use the -i parameter to set the pip source to a mirror server closest to you (e.g., the USTC mirror) to greatly speed up the installation.
```

## Troubleshooting

After installation, you can run the command `python3 -m lamda.client` to verify that it was installed correctly. If you encounter an encoding error such as `UnicodeEncodeError: 'ascii' codec can't encode characters in...`, it may be because the path contains Chinese characters, causing gRPC to fail to handle them properly. You can run the following code to verify whether this is the issue.

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

```{note}
If the printed sys.path contains one or more paths with Chinese characters, check your system environment variables, PYTHONPATH, or other Python-related environment variables, and remove any paths that contain Chinese characters.
```

If you encounter other import errors such as `ImportError`, run the following command to force a reinstall.

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

```{tip}
If these problems persist, we recommend creating a virtualenv to use.
```

```{attention}
After installation, you may need to use pip to update all third-party libraries that depend on frida, such as frida-tools, objection, etc. Otherwise, subtle anomalies may occur when you use these tools later.
```