Installing the Client

This section explains how to install the Python library配套 for FIRERPA. If you don’t use Python, you can skip this section.

Before getting started, make sure you have Python version 3.6 to 3.12 installed on your computer. Then run:

pip3 install -U lamda[full]

If the above command results in an error, try the following variant with quotes. The difference is the addition of quotation marks, as different systems or Python versions may interpret the command differently. You can try both versions.

pip3 install -U 'lamda[full]'

Tip

Using the -i parameter to set the PIP source to a nearby server (e.g., USTC mirror) can significantly speed up installation.

Troubleshooting

After installation, you can run python3 -m lamda.client to verify whether the installation was successful. If you encounter an encoding error such as UnicodeEncodeError: 'ascii' codec can't encode characters in..., it’s likely because your system path contains Chinese characters, which gRPC cannot handle properly. Run the following code to confirm if this is the issue:

import sys
print(sys.path)

Note

If the output of sys.path includes one or more paths containing Chinese characters, check your system environment variables, PYTHONPATH, or any other Python-related environment variables and remove any paths with Chinese characters, ensuring no conflicts arise.

If you encounter other import errors (ImportError), reinstall the package using the following command to force a reinstallation:

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

Tip

If problems persist, we recommend using a virtual environment (virtualenv).

Attention

After installation, you may need to update any third-party libraries that depend on frida (e.g., frida-tools, objection) via pip. Otherwise, you might encounter subtle issues when using these tools later.