Roop-Floyd Installation

Dee P. • Software Developer • Aug 13, 2023

What You Need First

Before we install Roop-Floyd, make sure you have:

  1. Windows PC (10/11)
  2. Internet connection
  3. Basic familiarity with Terminal/Command Prompt

Step 1 — Install Anaconda (Python Manager)

  1. Roop-Floyd runs using Python. Best way is via Anaconda / Miniconda.
  2. Go to Anaconda website & download Anaconda/Miniconda.
  3. Run installer → choose Add to PATH (optional but helpful).
  4. Finish installation.

Step 2 — Download Roop-Floyd Files

  1. Roop-Floyd files are hosted on a code repository (Codeberg/Cognibuild).
  2. Open the Roop-Floyd repository (codeberg.org).
  3. Or you can download at the end of this tutorial (at the bottom).
  4. Click Download ZIP.
  5. Extract ZIP to a folder you can find easily (e.g., C:\RoopFloyd).


Step 3 — Open Anaconda Prompt

1. Open Anaconda Prompt (Search it in Start Menu).

Step 4 — Create & Activate Python Environment

This makes sure Roop runs isolated from other software.

In Anaconda Prompt:
conda create -n roopfloyd python=3.10
conda activate roopfloyd
Replace roopfloyd with any name you want.

Step 5 — Go to Roop-Floyd Folder

In the same prompt:
cd C:\RoopFloyd
If your folder is somewhere else, type its path instead.

Step 6 — Install Dependencies

Now install all Python dependencies:
pip install -r requirements.txt
This downloads the packages needed for Roop to run.

If it fails, try installing a few manually:
pip install torch torchvision onnxruntime insightface.

Step 7 — Download Models

  1. Some AI models must be installed manually:
  2. Look for inswapper_128.onnx online (GitHub/links in other guides).
  3. Place it inside the models folder in Roop directory.

Rename it exactly:
models\inswapper_128.onnx
If Roop starts without it, it still may download its own but manual is faster.

Step 8 — Run Roop-Floyd

After all installs finished:

python run.py

Step 9 — Quick Usage (Face Swap Mode)

  1. Upload a source image (photo of face you want).
  2. Upload a target video/photo (where face goes).
  3. Set options like post-processing (CodeFormer, GFPGAN).
  4. Hit “Start”.

Output will save to output/ folder.


Common Issues & Fixes

Error with Python/Torch?
Try installing correct torch wheels for your GPU:
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128


Missing Model error?
Download and place inswapper_128.onnx in models/.

Roop crashes on first run?
It may auto-download models — just give it time.

Fast Summary
1) Install Anaconda
2) Download Roop-Floyd .zip
3) Create Python env via conda
4) cd into project folder
5) pip install -r requirements.txt
6) Add AI model file into /models
7) python run.py

Output → go to output/ and enjoy your face-swaps.

You can download full installation roop-floyd with all the attributes, just copy-paste to (C:\) drive: Download

or small size raw roop-floyd: Download