[Guide]Linux Install Guide: Installer Method

Installing and setting up FaceSwap
Forum rules
Read the FAQs and search the forum before posting a new topic.

Please mark any answers that fixed your problems so others can find the solutions.
Post Reply
User avatar
torzdf
Posts: 226
Joined: Fri Jul 12, 2019 12:53 am
Answers: 57
Has thanked: 8 times
Been thanked: 43 times

[Guide]Linux Install Guide: Installer Method

Post by torzdf » Mon Aug 19, 2019 3:56 pm

Installing Faceswap on Linux is a breeze. The Linux installer installs everything you need except for your Graphics drivers.

We recommend using a lightweight Distribution (such as Xubuntu) but the installer should work fine on all Linux flavors.
  1. If you are using a Graphics card (which is highly recommended. Faceswapping on CPU is incredibly slow), then make sure your drivers are up to date.
  2. Download the Faceswap Installer
  3. Open up a terminal emulator, navigate to the download location then enter the following command as a normal user (do not execute this command as sudo or root):

    Code: Select all

    bash ./faceswap_setup_x64.sh
    linux_install01.png
    linux_install01.png (15.54 KiB) Viewed 1344 times
  4. The Faceswap Logo will display followed by some information. Make sure you read it thoroughly (specifically the part about user permissions on destination folders) then press Enter to continue.
    linux_install02.png
    linux_install02.png (53.21 KiB) Viewed 1344 times
  5. Conda
    Faceswap uses Conda as it handles the installation of all prerequisites (git, Cuda, Tensorflow etc) and contains them within their own environment, away from the rest of your system.
    • If an existing Conda install is found you will be asked if you want to use it. You should select Yes. These next options will only be displayed if an existing Conda install was not found, or if you select No to using the existing Conda install.
    • The default install location for Conda will be fine in 99% of cases. If you do wish to install it elsewhere, then make sure that:
      1. Your user has permissions to write to the location you select.
      2. There are no spaces in the location that you provide (this is a Conda limitation and is outside of our control).
      If you are happy with the default location then just press Enter
      linux_install03.png
      linux_install03.png (24.47 KiB) Viewed 1344 times
    • You will be asked if you want to add Conda to PATH. This is up to you, but it will make life easier if you say Yes. It basically means that you will have access to the `conda` command from the command line, and won't need to search for the executable inside the `miniconda3` folder. Hit Enter to select the default value or press n if you don't want Conda added to your path.
      linux_install04.png
      linux_install04.png (24.31 KiB) Viewed 1344 times
    • Faceswap is run inside a "virtual environment". This is a Python environment that is kept separate from the rest of your system to avoid conflicts. The environment needs a name. The default should be fine, but if you have multiple installs then you will want to set a specific environment name here. NB: If an environment already exists with the name you select then it will be deleted (you will be notified if this will occur prior to commencing install). Press Enter to use the default `faceswap` or enter your preferred name here.
      linux_install05.png
      linux_install05.png (20.03 KiB) Viewed 1344 times
  6. Faceswap
    • The location that you want Faceswap installed to. The default will be fine in 99% of cases, but as with the Conda install, if you do select a different location, then make sure your user has permission to write to it. NB: If a folder pre-exists at the location given, then it will be deleted (you will be notified if this will occur prior to commencing install). Press Enter to use the default location or enter your preferred location here.
      linux_install06.png
      linux_install06.png (19.66 KiB) Viewed 1344 times
    • Faceswap can be run on Nvidia or AMD GPUs or on CPU. The software it installs varies depending on what you select here, so make sure you select the correct option for your system. Enter 1 for Nvidia, 2 for AMD or 3 for CPU,
      linux_install07.png
      linux_install07.png (24.72 KiB) Viewed 1344 times
  7. Post Install Actions
    • If you are running a Desktop Environment you will be given the option to create a Desktop shortcut to enter the GUI. This makes opening Faceswap a lot easier, so unless you have a good reason not to, you should select Y here.
      linux_install08.png
      linux_install08.png (23.62 KiB) Viewed 1344 times
  8. Finally you will be able to review your options. If you are happy press Y to proceed with the install, or press Enter to abort.
    linux_install09.png
    linux_install09.png (32.48 KiB) Viewed 1344 times
  9. The installer will proceed to download the resources it needs from the internet and install as per your options. After a period of time Faceswap installation will complete and you will be ready to launch.
My word is final

Tags:

User avatar
ajgoyt
Posts: 5
Joined: Tue Nov 05, 2019 5:23 am

Re: [Guide]Linux Install Guide: Installer Method

Post by ajgoyt » Sun Nov 10, 2019 5:22 pm

Hello i installed FS on a linux mint install using the guide defaults and it appeared to install fine, my GPU is not very good but with some testing i saw some errors, (1) major one was CUDNN is not found , if i look around in conda i see that it has listings of cuda in the pkgs folder (i attached a screenshot)

I tried to attach my log file but it says (Invalid file extension: crash_report.2019.11.10.005746130939.log)


should i copy the crash report and paste it here or?

thanks
Attachments
Screenshot from 2019-11-10 09-07-11.png
Screenshot from 2019-11-10 09-07-11.png (3.59 KiB) Viewed 1148 times

User avatar
torzdf
Posts: 226
Joined: Fri Jul 12, 2019 12:53 am
Answers: 57
Has thanked: 8 times
Been thanked: 43 times

Re: [Guide]Linux Install Guide: Installer Method

Post by torzdf » Sun Nov 10, 2019 7:14 pm

You should now be able to upload your crash report (I have enabled text files).

Alternatively, you can paste the crash report here inside [code] blocks or put it on pastebin and link.
My word is final

User avatar
ajgoyt
Posts: 5
Joined: Tue Nov 05, 2019 5:23 am

Re: [Guide]Linux Install Guide: Installer Method

Post by ajgoyt » Mon Nov 11, 2019 5:41 am

ok here is the crash report
Attachments
crash_report.2019.11.10.005746130939.log
(69.5 KiB) Downloaded 34 times

User avatar
torzdf
Posts: 226
Joined: Fri Jul 12, 2019 12:53 am
Answers: 57
Has thanked: 8 times
Been thanked: 43 times

Re: [Guide]Linux Install Guide: Installer Method

Post by torzdf » Mon Nov 11, 2019 9:56 am

That GPU is right at the bottom end of what will run....

In the first instance, enable the "Allow Growth" option. There is a bug in TF with some combinations of OS/GPU/Cuda (there appears to be no consistent pattern) where this is necessary.

I imagine the next thing that will happen is you run out of VRAM, but there are tips to get around that issue.
My word is final

Post Reply