ussoewwin/Insightface_for_windows

InsightFace prebuilt wheels for Windows

Prebuilt Windows x64 wheels for InsightFace (python-package), including native extensions built with --with-face3d where noted. These wheels are maintained by ussoewwin for local development on Windows; they are not an official release from the InsightFace project.

Upstream project: deepinsight/insightface · insightface.ai

---

Available wheels

File	Python	InsightFace	Notes
insightface-0.7.3-cp311-cp311-win_amd64.whl	3.11	0.7.3	Legacy build
insightface-0.7.3-cp312-cp312-win_amd64.whl	3.12	0.7.3	Legacy build
insightface-0.7.3-cp313-cp313-win_amd64.whl	3.13	0.7.3	Legacy build
insightface-1.0.1-cp314-cp314-win_amd64.whl	3.14	1.0.1	face3d + mesh_core_cython included (--with-face3d)

Direct download (Python 3.14 / 1.0.1):

https://huggingface.co/ussoewwin/Insightface_for_windows/resolve/main/insightface-1.0.1-cp314-cp314-win_amd64.whl

---

Python 3.14 / insightface 1.0.1 — requirements

Component	Version (verified example)
OS	Windows 10/11 x64
Python	3.14.x (e.g. 3.14.5)
CUDA Toolkit	13.2
cuDNN	9.22 (on PATH, often ...\CUDNN\v9.22\bin\13.2\x64)
ONNX Runtime GPU	CUDA 13 nightly index only (not plain PyPI CPU+GPU mix)

Example ORT-GPU (after removing CPU and GPU packages):

pip uninstall -y onnxruntime onnxruntime-gpu
pip install --pre --index-url https://aiinfra.pkgs.visualstudio.com/PublicPackages/_packaging/ort-cuda-13-nightly/pypi/simple/ onnxruntime-gpu

Verified example: onnxruntime-gpu 1.27.0.dev20260511001 (cp314-cp314-win_amd64).

Important for 1.0.1

• Do not install both onnxruntime (CPU) and onnxruntime-gpu; CPU wins and breaks GPU inference.
• Install the wheel with --no-deps because setup.py still declares CPU onnxruntime as a dependency.
• The 1.0.1 wheel must be built with python setup.py bdist_wheel --with-face3d or mesh_core_cython is missing.

Runtime dependencies (install separately in your venv):

pip install numpy onnx tqdm requests scipy scikit-image opencv-python
pip install cython albumentations matplotlib Pillow scikit-learn

---

Installation (Python 3.14 example)

# 1) Set up onnxruntime-gpu (see above) — CPU onnxruntime must NOT remain installed

# 2) Install the wheel without pulling CPU onnxruntime
pip install --force-reinstall --no-deps https://huggingface.co/ussoewwin/Insightface_for_windows/resolve/main/insightface-1.0.1-cp314-cp314-win_amd64.whl

# 3) Install runtime deps if not already present
pip install numpy onnx tqdm requests scipy scikit-image opencv-python cython albumentations matplotlib Pillow scikit-learn

Legacy Python 3.11–3.13 wheels (0.7.3): use the matching filename from this repo; follow the same --no-deps pattern if you manage ORT-GPU yourself.

---

Quick verification

python -c "import onnxruntime as ort; ort.preload_dlls(); print(ort.__version__); print(ort.get_available_providers())"
python -c "import insightface; print(insightface.__version__)"
python -c "from insightface.app import FaceAnalysis; app=FaceAnalysis(name='buffalo_l', providers=['CUDAExecutionProvider','CPUExecutionProvider']); app.prepare(ctx_id=0, det_size=(640,640)); print('OK')"
python -c "from insightface.thirdparty.face3d.mesh import render; import insightface.thirdparty.face3d.mesh.cython.mesh_core_cython as m; print('face3d OK')"

Expected for a working GPU setup:

• CUDAExecutionProvider appears in get_available_providers()
• insightface version 1.0.1
• FaceAnalysis prepares without error
• face3d.mesh.render and mesh_core_cython import successfully

---

Build from source (Windows)

For Python 3.14 / CUDA 13.2 / insightface 1.0.1, the critical build command is:

cd insightface\python-package
python setup.py bdist_wheel --with-face3d

Reference write-ups:

• Python 3.13 baseline: How to build insightface for Python3.13.x on Windows (GJL)
• Python 3.14 notes: same flow with ORT ort-cuda-13-nightly, CUDA 13.2, cuDNN 9.22, and mandatory --with-face3d

---

Disclaimer

• No performance benchmarks have been run on these wheels.
• No multi-environment testing beyond the maintainer’s build host.
• This is an unofficial community build. Use at your own risk.
• Face models (e.g. buffalo_l) are downloaded separately by InsightFace at runtime; this repo ships the Python package wheel only.

---

License

This repository distributes wheels built from InsightFace source code. InsightFace is licensed under Apache-2.0 (see upstream LICENSE). Wheel filenames and tags reflect the upstream package version and target CPython ABI.

---

Changelog

Date	Change
2025-09-15	Added Python 3.13 / insightface 0.7.3 wheel
2026-06-10	Added Python 3.14 / insightface 1.0.1 wheel (--with-face3d); updated model card