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-26T06:51:58.868Z
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": "nvidia",
    "gpu_model": "nvidia quadro t2000 with max-q design",
    "ram_gb": 32,
    "vram_gb": 4
  },
  "os": {
    "platform": "Windows",
    "distro": "Microsoft Windows 10 Pro",
    "release": "10.0.19045",
    "codename": "22H2",
    "kernel": "10.0.19045",
    "arch": "x64",
    "build": "19045",
    "servicepack": "0.0",
    "uefi": true
  },
  "system": {
    "manufacturer": "LENOVO",
    "model": "20TJS2T100",
    "version": "ThinkPad P1 Gen 3",
    "virtual": false
  },
  "cpu": {
    "manufacturer": "Intel",
    "brand": "Core™ i9-10885H",
    "vendor": "GenuineIntel",
    "family": "6",
    "model": "165",
    "stepping": "2",
    "speed": 2.4,
    "speedMin": 2.4,
    "speedMax": 2.4,
    "cores": 16,
    "physicalCores": 8,
    "processors": 1,
    "performanceCores": 16,
    "efficiencyCores": 0,
    "virtualization": true,
    "cache": {
      "l1d": 256,
      "l1i": 256,
      "l2": 2097152,
      "l3": 16777216
    }
  },
  "memory": {
    "total": 34064392192,
    "free": 23611027456,
    "used": 10453331968,
    "active": 10453331968,
    "available": 23611068416,
    "buffers": 0,
    "cached": 0,
    "slab": 0,
    "buffcache": 0,
    "swaptotal": 5100273664,
    "swapused": 53477376,
    "swapfree": 5046796288
  },
  "gpus": [
    {
      "model": "nvidia quadro t2000 with max-q design"
    },
    {
      "model": "intel(r) uhd graphics"
    }
  ],
  "graphics": {
    "controllers": [
      {
        "vendor": "NVIDIA",
        "model": "NVIDIA Quadro T2000 with Max-Q Design",
        "bus": "PCI",
        "vram": 4096,
        "vramDynamic": false,
        "driverVersion": "573.57"
      },
      {
        "vendor": "Intel Corporation",
        "model": "Intel(R) UHD Graphics",
        "bus": "PCI",
        "vram": 1024,
        "vramDynamic": true
      }
    ],
    "displays": [
      {
        "model": "Default Monitor",
        "main": true,
        "builtin": true,
        "connection": "INTERNAL",
        "currentResX": 1536,
        "currentResY": 864,
        "resolutionX": 1920,
        "resolutionY": 1080,
        "pixelDepth": 32,
        "currentRefreshRate": 60
      }
    ]
  }
}

Logs

logs/api/run.js/1787726874696

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

[api shell.run]
Microsoft Windows [Version 10.0.19045.7548]
(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/1787726881136

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

[api shell.run]
Microsoft Windows [Version 10.0.19045.7548]
(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 facefusion.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_manager, translator
  File "C:\pinokio\api\facefusion-pinokio.git\facefusion\facefusion\benchmarker.py", line 8, in <module>
    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, BenchmarkResolution, BenchmarkSet, DownloadProvider, DownloadProviderSet, DownloadScope, EncoderSet, ExecutionProvider, ExecutionP
roviderSet, FaceDetectorModel, FaceDetectorSet, FaceLandmarkerModel, FaceMaskArea, FaceMaskAreaSet, FaceMaskRegion, FaceMaskRegionSet, FaceMaskType, FaceOccluderModel, FaceParserModel, FaceSelectorGender, FaceSelectorMode, Fac
eSelectorOrder, FaceSelectorRace, Gender, ImageFormat, ImageTypeSet, JobStatus, LogLevel, LogLevelSet, Race, Score, TempFrameFormat, TempPixelFormat, UiWorkflow, VideoEncoder, VideoFormat, VideoMemoryStrategy, VideoPreset, Vid
eoTypeSet, VoiceExtractorModel, 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>