Installing the Client

This chapter introduces how to install the Python library that accompanies FIRERPA. If you don’t need Python, you can skip this chapter. Before starting, please make sure that you have installed any version of Python from 3.6 to 3.12 on your computer, then please execute:

pip3 install -U lamda[full]

If the above command gives an error, please execute the version of the command below. The difference is that it has an extra quote, because on different systems or Python versions, it might be understood differently, so you can try both methods.

pip3 install -U 'lamda[full]'

Tip

Setting the PIP source to your nearest server such as the USTC source etc. using the -i parameter will greatly improve the installation speed.

Troubleshooting

After installation, you can execute the command python3 -m lamda.client to check if the installation is correct. If there is an encoding error UnicodeEncodeError: 'ascii' codec can't encode characters in..., it’s because your path contains Chinese characters, and gRPC cannot handle such paths correctly. You can execute the following code to verify if this is the problem.

import sys
print (sys.path)

Note

If the output of sys.path contains one or more Chinese paths, then check your system environment variables, PYTHONPATH, or other PYTHON-related environment variables, and remove the Chinese paths from them, ensuring there are no problems.

If there are other import errors ImportError, please execute the following command to force reinstallation.

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

Tip

If these problems still exist, we recommend you create a virtualenv to use.

Attention

After installation, you may need to use pip to update any third-party libraries that depend on frida, such as frida-tools, objection, etc., otherwise there may be hard-to-detect abnormalities when using these tools later.