Skip to main content

Install FoxyFace Linux

Installing on Linux is done through the terminal using Python and PyPI (pip).

1. Check Python Version​

Ensure you have a supported Python version:

python3 --version

The Python version should be 3.12, 3.13, or 3.14.

Important for AMD users

If you plan to use an AMD GPU (ROCm), you must use Python 3.12.


2. Create and Activate a Virtual Environment​

tip

Don't forget to create a separate folder for FoxyFace


It is strongly recommended to install FoxyFace inside an isolated virtual environment:

python3 -m venv venv
source venv/bin/activate

3. Install FoxyFace​

Now you need to find out what video card you have:

NVIDIA

For NVIDIA GPUs with CUDA support:

pip install "foxyface[nvidia]" --extra-index-url https://download.pytorch.org/whl/cu126
AMD (ROCm)

⚠️ You must use Python 3.12. Newer versions of Python are currently not supported.

pip install "foxyface[rocm]" --extra-index-url https://repo.radeon.com/rocm/manylinux/rocm-rel-6.4.4/
CPU only / Intel / Other

All calculations will be performed on the CPU:

pip install "foxyface[cpu]"

4. Run the Application​

Once the installation is complete, the easiest and recommended way to start the program is:

venv/bin/foxyface

💡 Why launch it this way?
When you close your terminal or open a new one later, the virtual environment will no longer be active. Running venv/bin/foxyface directly calls the program inside your virtual environment without forcing you to run source venv/bin/activate every time.

(If you already have your virtual environment activated in the current terminal, simply typing foxyface will also work).



Don't forget to install the special version of VRCFaceTracking

You can find complete instructions on how to do this on the “Installing VRCFaceTracking on Linux or macOS” (Click here) page.


An error occurred during installation​

This is most likely to happen because your system does not have the necessary build tools or system libraries. Check the terminal output to see what dependencies are missing in your distribution.


The program does not start​

The program should have created a file latest.log in the current working directory. This file will be needed when you want to report a bug on GitHub Issues or Discord #Jeka8833.