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 / Message | Type | Severity | Tags |
|---|---|---|---|
| Unsupported platform: system={system}, machine={machine} | exception | critical | native-library, platform, architecture, inspireface |
| Library not found at {lib_path}. System: {system}, Architect | exception | critical | native-library, missing-file, installation, inspireface |
| Unknown calling convention '{}' for function '{}' | exception | error | ctypes, calling-convention, native-library |
| Could not load %s. | exception | critical | native-library, dlopen, import-error, dependencies |
HERR_INVALID_PARAM {operation}: Input must be a numpy array | validation | error | validation, numpy, image, inspireface |
HERR_INVALID_IMAGE_STREAM_PARAM {operation}: Image must be 3-dimensional (H, W, C) | validation | error | validation, image, shape, numpy |
HERR_INVALID_FACE_FEATURE {operation}: Feature data must be a numpy array | validation | error | validation, feature-embedding, numpy, inspireface |
HERR_INVALID_CONTEXT_HANDLE {operation}: Session not initialized | exception | error | session-lifecycle, resource, context-handle, inspireface |
| {operation_name}: {str(e)} | exception | error | error-wrapping, decorator, debugging, inspireface |
| Failed to launch InspireFace automatically | exception | critical | initialization, resource, model, inspireface |
| Session parameter must be SessionCustomParameter or int | validation | error | validation, constructor, session, type-error |
| 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 |
| ModelScope is not available. You have two options: 1. Instal | exception | error | dependency, modelscope, download, optional-dependency |
| ModelScope is not available. Please install it with: pip ins | exception | error | dependency, modelscope, download, optional-dependency |
| Model file '{model_name}' not found in downloaded repository | exception | error | download, modelscope, file-not-found, model |
| Failed to download model from ModelScope: {e} | exception | error | download, network, modelscope, retryable |
| Model '{name}' not found. Available models: {list(self._MODE | validation | error | validation, model-name, registry, inspireface |
| Failed to download model: {e} | exception | error | network, download, model-cache, runtimeerror, inspireface |
| NV21 data size is not enough: expected {expected_size} bytes | validation | error | nv21, yuv, opencv, buffer-size, valueerror |
| Unsupported platform: {} {} | exception | error | build, wheel, platform, setup-py, cross-compilation |
| Unsupported system: {system} | exception | error | build, platform, setup-py, os-detection |
| Unable to import dependency onnxruntime. | exception | critical | dependency, onnxruntime, import, installation |
| The rec.addmaskparam command requires mxnet. Please install | exception | error | mxnet, cli, optional-dependency, import |
| The rec.addmaskparam command requires optional mask renderin | exception | error | optional-dependency, mxnet, import, cli, mask |
| Identity folder root not found: {root} | validation | error | path, dataset, validation, evaluation |
| no face detected | validation | warning | face-detection, evaluation, empty-result |
| multiple faces detected ({face_count}); expected exactly one | validation | warning | face-detection, multi-face, policy, evaluation |
| skipped multi-face image ({face_count} faces) | validation | warning | insightface, multi-face, face-detection, policy, evaluation |
| image read failure | validation | error | insightface, image-io, corrupt-file, evaluation |
| no face or embedding | validation | error | insightface, embedding, face-detection, evaluation |
| No verification pairs could be generated from the selected i | validation | error | insightface, verification, dataset, pairing, evaluation |
| 1:N without Auto Split requires gallery/ and probe/ folders. | validation | error | insightface, dataset-layout, identification, directory-structure |
| Dataset root not found: {root} | validation | error | insightface, path, dataset, filesystem |
| 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 |
| No gallery embeddings could be extracted. | validation | critical | insightface, gallery, embedding, evaluation |
| failed detection | validation | warning | face-detection, kyc, evaluation, data-quality |
| embedding unavailable | validation | error | embedding, recognition-model, kyc, evaluation |
| Face swap model load failed: {exc} | validation | error | insightface, face-swap, model-load, onnx |
| No usable face detected in source image. | validation | error | insightface, face-detection, no-face, face-swap |
| Target image could not be read. | validation | error | insightface, image-io, decode, face-swap |
| No usable face detected in target image. | validation | error | insightface, face-detection, keypoints, face-swap |
| OpenCV is required for video face swap: {exc} | validation | error | insightface, opencv, cv2, import-error, video |
| Video could not be opened. | validation | error | insightface, opencv, video-capture, codec |
| Video dimensions could not be read. | validation | error | insightface, opencv, video-metadata |
| Video writer could not be opened. | validation | error | insightface, opencv, video-writer, codec |
| 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 |
| Archive not initialized | exception | critical | initialization, launch, archive, startup-order, resource-pack |