Skip to content

Install FoxyFace Linux

Jump to bottom
Jeka8833 edited this page Sep 4, 2026 · 8 revisions

Warning

This page is out of date and will no longer be updated. You can find the latest information on the website: Install FoxyFace Linux

Click to view outdated content

Compiling on Linux is not a thankless task, so you'll have to work in the terminal. The whole idea is to install libraries and run a Python application, if you know simple methods on how to do that, I won't restrict you.

To install the FoxyFace program, follow these steps in order:

python3 --version

The Python version should be 3.12, 3.13, or 3.14. If it is not, google how to install one of these versions. It may work with older versions as well, but the author of the article has not tested it.

git clone --recurse-submodules https://github.com/Jeka8833/FoxyFace.git
cd FoxyFace/FoxyFace
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

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

Nvidia (Example for CUDA > 12.6 and cuDNN > 8)

Here is an example for CUDA version 12.6 and newer:

pip install torch torchvision --index-url https://download.pytorch.org/whl/cu126
pip install onnxruntime-gpu
AMD

You need to find out the version of your ROCm and then change the numbers in the link; a list of available versions can be found here. Here's the command for ROCm version 6.4.3:

pip install onnxruntime-rocm -f https://repo.radeon.com/rocm/manylinux/rocm-rel-6.4.3/
No GPU or Intel

In this case, you don't have many options; all calculations will be performed on the CPU. Here is the command that you need to execute:

pip install onnxruntime
python Main.py



[!important] If the installation was successful, don't forget to follow these steps:

  1. Install VRCFaceTracking Avalonia. The official Steam version of VRCFaceTracking will NOT run on Linux or MacOS!
  2. Install the Interface Module: Follow the guide for the FoxyFaceVRCFTInterface.

An error occurred during installation

This is most likely to happen because your system does not have the necessary libraries. See what is missing in your system and install it.


For the gods of Arch Linux

It's possible that FoxyFace doesn't install on Arch Linux, the reason is currently unknown, but some solution was found by one very good person. You can read about it here.


The program does not start

The program should have created a file "latest.log", this file will be needed when you want to report a bug on GitHub Issues or Discord #Jeka8833.

Home

Clone this wiki locally