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-24T09:58:20.665Z
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 geforce rtx 3060 laptop gpu",
    "ram_gb": 32,
    "vram_gb": 12
  },
  "os": {
    "platform": "Windows",
    "distro": "Microsoft Windows 11 Professionnel",
    "release": "10.0.26200",
    "codename": "25H2",
    "kernel": "10.0.26200",
    "arch": "x64",
    "build": "26200",
    "servicepack": "0.0",
    "uefi": true
  },
  "system": {
    "manufacturer": "Default string",
    "model": "Default string",
    "version": "Default string",
    "virtual": false
  },
  "cpu": {
    "manufacturer": "Intel",
    "brand": "Gen Intel® Core™ i9-12900HK",
    "vendor": "GenuineIntel",
    "family": "6",
    "model": "154",
    "stepping": "3",
    "speed": 2.5,
    "speedMin": 2.5,
    "speedMax": 2.5,
    "cores": 20,
    "physicalCores": 14,
    "processors": 1,
    "performanceCores": 20,
    "efficiencyCores": 0,
    "virtualization": true,
    "cache": {
      "l1d": 557056,
      "l1i": 720896,
      "l2": 12058624,
      "l3": 25165824
    }
  },
  "memory": {
    "total": 34079027200,
    "free": 26349842432,
    "used": 7729184768,
    "active": 7729184768,
    "available": 26349842432,
    "buffers": 0,
    "cached": 0,
    "slab": 0,
    "buffcache": 0,
    "swaptotal": 2147483648,
    "swapused": 0,
    "swapfree": 2147483648
  },
  "gpus": [
    {
      "model": "intel(r) iris(r) xe graphics"
    },
    {
      "model": "nvidia geforce rtx 3060 laptop gpu"
    }
  ],
  "graphics": {
    "controllers": [
      {
        "vendor": "Intel Corporation",
        "model": "Intel(R) Iris(R) Xe Graphics",
        "bus": "PCI",
        "vram": 2047.99609375,
        "vramDynamic": true
      },
      {
        "vendor": "NVIDIA",
        "model": "NVIDIA GeForce RTX 3060 Laptop GPU",
        "bus": "PCI",
        "vram": 12288,
        "vramDynamic": false,
        "driverVersion": "546.01"
      }
    ],
    "displays": [
      {
        "model": "L740HS",
        "main": true,
        "builtin": false,
        "connection": "DP",
        "currentResX": 1920,
        "currentResY": 1080,
        "resolutionX": 1920,
        "resolutionY": 1080,
        "pixelDepth": 32,
        "currentRefreshRate": 60
      }
    ]
  }
}

Logs

logs/api/run.js/1787565482826

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

[api shell.run]
Microsoft Windows [version 10.0.26200.9168]
(c) Microsoft Corporation. Tous droits réservés.

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/1787565489464

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

[api shell.run]
Microsoft Windows [version 10.0.26200.9168]
(c) Microsoft Corporation. Tous droits réservés.

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, ExecutionProviderSet, FaceDetectorModel, FaceDetectorSet, FaceLandmarkerModel, FaceMaskArea, FaceMaskAreaSet, FaceMaskRegion, FaceMaskRegionSet, FaceMaskType, FaceOccluderModel, FaceParserModel, FaceSelectorGender, FaceSelectorMode, FaceSelectorOrder, FaceSelectorRace, Gender, ImageFormat, ImageTypeSet, JobStatus, LogLevel, LogLevelSet, Race, Score, TempFrameFormat, TempPixelFormat, UiWorkflow, VideoEncoder, VideoFormat, VideoMemoryStrategy, VideoPreset, VideoTypeSet, 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>