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:

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.

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.

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.

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.