FaceFusion 3.8.2: ModuleNotFoundError: No module named 'cv2'

App: FaceFusion 3.8.2 (facefusion-pinokio.git)
Repo: https://github.com/facefusion/facefusion-pinokio.git
Generated: 2026-08-25T17:57:07.200Z
Pinokio: 8.0.40
Platform: win32 x64
Node: v22.21.1

Summary

System

{
  "pinokio": {
    "version": "8.0.40",
    "node": "v22.21.1",
    "platform": "win32",
    "arch": "x64"
  },
  "hardware": {
    "gpu": "amd",
    "gpu_model": "amd radeon(tm) graphics",
    "ram_gb": 15,
    "vram_gb": 1
  },
  "os": {
    "platform": "Windows",
    "distro": "Microsoft Windows 10 Home",
    "release": "10.0.19045",
    "codename": "22H2",
    "kernel": "10.0.19045",
    "arch": "x64",
    "build": "19045",
    "servicepack": "0.0",
    "uefi": true
  },
  "system": {
    "manufacturer": "Gigabyte Technology Co., Ltd.",
    "model": "A520M K V2",
    "version": "-CF",
    "virtual": false
  },
  "cpu": {
    "manufacturer": "AMD",
    "brand": "Ryzen 5 5600G with Radeon Graphics",
    "vendor": "AuthenticAMD",
    "family": "25",
    "model": "80",
    "stepping": "0",
    "revision": "20480",
    "speed": 3.5,
    "speedMin": 3.5,
    "speedMax": 3.9,
    "cores": 12,
    "physicalCores": 6,
    "processors": 1,
    "performanceCores": 12,
    "efficiencyCores": 0,
    "virtualization": false,
    "cache": {
      "l1d": 192,
      "l1i": 192,
      "l2": 3145728,
      "l3": 16777216
    }
  },
  "memory": {
    "total": 16504434688,
    "free": 5686575104,
    "used": 10817859584,
    "active": 10817859584,
    "available": 5686575104,
    "buffers": 0,
    "cached": 0,
    "slab": 0,
    "buffcache": 0,
    "swaptotal": 16642998272,
    "swapused": 138412032,
    "swapfree": 16504586240
  },
  "gpus": [
    {
      "model": "amd radeon(tm) graphics"
    }
  ],
  "graphics": {
    "controllers": [
      {
        "vendor": "Advanced Micro Devices, Inc.",
        "model": "AMD Radeon(TM) Graphics",
        "bus": "PCI",
        "vram": 512,
        "vramDynamic": true
      }
    ],
    "displays": [
      {
        "model": "HDMI",
        "main": true,
        "builtin": false,
        "connection": "HDMI",
        "currentResX": 1280,
        "currentResY": 1024,
        "resolutionX": 1280,
        "resolutionY": 1024,
        "pixelDepth": 32,
        "currentRefreshRate": 60
      }
    ]
  }
}

Logs

logs/api/run.js/1787680543808

Source: api / run.js
Lines: 8 total, last 8 included

[api shell.run]
Microsoft Windows [Version 10.0.19045.6466]
(c) Microsoft Corporation. All rights reserved.  

C:\pinokio\api\facefusion-pinokio.git\facefusion>conda_hook & conda deactivate & conda deactivate &
 conda deactivate & conda activate base && git checkout --quiet -- facefusion

(base) C:\pinokio\api\facefusion-pinokio.git\facefusion>

logs/api/run.js/1787680549738

Source: api / run.js
Lines: 31 total, last 31 included

[api shell.run]
Microsoft Windows [Version 10.0.19045.6466]
(c) Microsoft Corporation. All rights reserved.  

C:\pinokio\api\facefusion-pinokio.git\facefusion>conda_hook & conda deactivate & conda deactivate &
 conda deactivate & conda activate "C:\pinokio\api\facefusion-pinokio.git\.env" && python facefusio
n.py run
Traceback (most recent call last):
  File "C:\pinokio\api\facefusion-pinokio.git\facefusion\facefusion.py", line 7, in <module>       
    from facefusion import conda, core
  File "C:\pinokio\api\facefusion-pinokio.git\facefusion\facefusion\core.py", line 8, in <module>  
    from facefusion import benchmarker, cli_helper, content_analyser, hash_helper, logger, state_ma
nager, translator
  File "C:\pinokio\api\facefusion-pinokio.git\facefusion\facefusion\benchmarker.py", line 8, in <mo
dule>
    import facefusion.choices
  File "C:\pinokio\api\facefusion-pinokio.git\facefusion\facefusion\choices.py", line 5, in <module
>
    from facefusion.types import Angle, AudioEncoder, AudioFormat, AudioTypeSet, BenchmarkMode, Ben
chmarkResolution, BenchmarkSet, DownloadProvider, DownloadProviderSet, DownloadScope, EncoderSet, E
xecutionProvider, ExecutionProviderSet, FaceDetectorModel, FaceDetectorSet, FaceLandmarkerModel, Fa
ceMaskArea, FaceMaskAreaSet, FaceMaskRegion, FaceMaskRegionSet, FaceMaskType, FaceOccluderModel, Fa
ceParserModel, FaceSelectorGender, FaceSelectorMode, FaceSelectorOrder, FaceSelectorRace, Gender, I
mageFormat, ImageTypeSet, JobStatus, LogLevel, LogLevelSet, Race, Score, TempFrameFormat, TempPixel
Format, UiWorkflow, VideoEncoder, VideoFormat, VideoMemoryStrategy, VideoPreset, VideoTypeSet, Voic
eExtractorModel, WorkflowMode, WorkflowStrategy
  File "C:\pinokio\api\facefusion-pinokio.git\facefusion\facefusion\types.py", line 6, in <module> 
    import cv2
ModuleNotFoundError: No module named 'cv2'

(C:\pinokio\api\facefusion-pinokio.git\.env) C:\pinokio\api\facefusion-pinokio.git\facefusion>