ErrLookup › deepinsight/insightface

deepinsight/insightface

State-of-the-art 2D and 3D Face Analysis Project · Python · 1,153 source files

Analyzed at 7fadd420c2 on 2026-08-28. 50 documented errors.

Code / MessageTypeSeverityTags
RGA buffer allocation failed
exception error rga, rockchip, memory-allocation, buffer-cache, out-of-memory
out_of_range in Parameter::get :
exception error configuration, missing-key, out-of-range, json-config, resource-pack
Unsupported platform: system=
exception critical native-library, platform, architecture, inspireface
Archive not initialized
exception critical initialization, launch, archive, startup-order, resource-pack
Identity folder root not found
validation error path, dataset, validation, evaluation
The rec.addmaskparam command requires optional mask…
exception error optional-dependency, mxnet, import, cli, mask
Unsupported platform
exception error build, wheel, platform, setup-py, cross-compilation
Failed to launch InspireFace automatically
exception critical initialization, resource, model, inspireface
ModelScope is not available. Please install it with: pip…
exception error dependency, modelscope, download, optional-dependency
Library not found at
exception critical native-library, missing-file, installation, inspireface
Unsupported system
exception error build, platform, setup-py, os-detection
Failed to download model
exception error network, download, model-cache, runtimeerror, inspireface
multiple faces detected
validation warning face-detection, multi-face, policy, evaluation
{operation_name}: {str(e)}
exception error error-wrapping, decorator, debugging, inspireface
Could not load .
exception critical native-library, dlopen, import-error, dependencies
Face swap model load failed
validation error insightface, face-swap, model-load, onnx
Image must be numpy.ndarray or ImageStream
validation error validation, image, type-error, inspireface
exec_param must be SessionCustomParameter or int
validation error validation, pipeline, bitmask, inspireface
skipped multi-face image
validation warning insightface, multi-face, face-detection, policy, evaluation
no face detected
validation warning face-detection, evaluation, empty-result
Model file ' ' not found in downloaded repository
exception error download, modelscope, file-not-found, model
1:N without Auto Split requires gallery/ and probe/ folders.
validation error insightface, dataset-layout, identification, directory-structure
HERR_INVALID_FACE_FEATURE
: Feature data must be a numpy array
validation error validation, feature-embedding, numpy, inspireface
Unable to import dependency onnxruntime.
exception critical dependency, onnxruntime, import, installation
Unknown calling convention
exception error ctypes, calling-convention, native-library
image read failure
validation error insightface, image-io, corrupt-file, evaluation
HERR_INVALID_CONTEXT_HANDLE
: Session not initialized
exception error session-lifecycle, resource, context-handle, inspireface
ModelScope is not available. You have two options: 1…
exception error dependency, modelscope, download, optional-dependency
Failed to download model from ModelScope
exception error download, network, modelscope, retryable
no face or embedding
validation error insightface, embedding, face-detection, evaluation
NV21 data size is not enough: expected
validation error nv21, yuv, opencv, buffer-size, valueerror
Session parameter must be SessionCustomParameter or int
validation error validation, constructor, session, type-error
The rec.addmaskparam command requires mxnet. Please install…
exception error mxnet, cli, optional-dependency, import
HERR_INVALID_PARAM
: Input must be a numpy array
validation error validation, numpy, image, inspireface
No gallery embeddings could be extracted.
validation critical insightface, gallery, embedding, evaluation
HERR_INVALID_IMAGE_STREAM_PARAM
: Image must be 3-dimensional (H, W, C)
validation error validation, image, shape, numpy
No verification pairs could be generated from the selected…
validation error insightface, verification, dataset, pairing, evaluation
1:N evaluation requires at least one gallery image.
validation error insightface, gallery, dataset, identification
1:N evaluation requires at least one known probe image.
validation error insightface, probe, dataset, identification
Model ' ' not found. Available models
validation error validation, model-name, registry, inspireface
embedding unavailable
validation error embedding, recognition-model, kyc, evaluation
failed detection
validation warning face-detection, kyc, evaluation, data-quality
No usable face detected in source image.
validation error insightface, face-detection, no-face, face-swap
Dataset root not found
validation error insightface, path, dataset, filesystem
Video writer could not be opened.
validation error insightface, opencv, video-writer, codec
OpenCV is required for video face swap
validation error insightface, opencv, cv2, import-error, video
Video dimensions could not be read.
validation error insightface, opencv, video-metadata
No usable face detected in target image.
validation error insightface, face-detection, keypoints, face-swap
Target image could not be read.
validation error insightface, image-io, decode, face-swap
Video could not be opened.
validation error insightface, opencv, video-capture, codec