yfeng95/face3d

Health v2 · maintenance only

Flags: no_releases no_license

Adoption not part of the score

2779 stars · 608 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A lightweight Python library implementing core 3D face processing functions: 3D morphable model (3DMM) generation and fitting, mesh I/O, transforms, camera projection, lighting, and rasterization rendering. Performance-critical parts (e.g., rasterization) are compiled from C++ via Cython, while slower numpy versions are kept for readability and learning, with formulas and references included in the code.

Use cases

• reconstruct a 3D face from a single image with key points
• generate random 3D faces from a morphable model
• fit a 3DMM to 68 facial landmarks
• render a face mesh with different lighting and cameras
• transform and rotate 3D face meshes
• read and write OBJ mesh files for faces
• learn 3D face reconstruction algorithms with readable numpy code

When to choose

• you are learning or researching 3D face reconstruction and want clean, formula-annotated implementations
• you need a lightweight mesh processing and rendering toolkit without heavy dependencies like OpenCV or Eigen
• you want to prototype 3DMM fitting or face generation experiments in Python
• you need fast rasterization for face meshes via the compiled Cython modules

When to avoid

• you need production software - the project has no license file and its last release was in 2019
• you need a general-purpose 3D graphics or mesh tool (consider Open3D, trimesh, or pyrender)
• you want state-of-the-art deep-learning-based 3D face reconstruction rather than classic 3DMM methods
• you need maintained support, bug fixes, or compatibility with recent Python versions

Facets

library · maturity maintenance

image-processing computer-vision graphics computer-vision graphics machine-learning python cpp cross-platform 3dmm 3d-face-reconstruction mesh-processing cython morphable-model face-rendering rasterization obj-mesh facial-landmarks

Member repositories

For agents

markdown · JSON · MCP: product_card(name="yfeng95/face3d")