{"id":21320,"library":"face-recognition-models","title":"face-recognition-models","description":"Models used by the face_recognition package. Version 0.3.0 provides pre-trained models for face detection, facial landmarks, and face recognition (dlib models). The package is a dependency of face_recognition, not typically installed standalone. Release cadence is low.","status":"active","version":"0.3.0","language":"python","source_language":"en","source_url":"https://github.com/ageitgey/face_recognition_models","tags":["face-recognition","models","dlib"],"install":[{"cmd":"pip install face-recognition-models","lang":"bash","label":"Install with pip"}],"dependencies":[],"imports":[{"note":"Used to locate model files (e.g., face_recognition_models.models_path()).","symbol":"face_recognition_models","correct":"import face_recognition_models"}],"quickstart":{"code":"import face_recognition_models\nprint(face_recognition_models.models_path())\nfrom face_recognition_models import models_path\nimport os\nmodel_path = os.path.join(models_path(), 'dlib_face_recognition_resnet_model_v1.dat')\nprint(model_path)","lang":"python","description":"Locate the directory containing pre-trained models."},"warnings":[{"fix":"Use face_recognition package for typical usage.","message":"This package simply downloads model files; it is a dependency of face_recognition. Install it independently only if you need the model files directly.","severity":"gotcha","affected_versions":"all"},{"fix":"Use models_path() to get the directory, then construct the full path to the specific model file.","message":"The models_path() function returns the directory where models are stored, not a single model file. Many users incorrectly assume it's a single model.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install face-recognition-models","cause":"The package is not installed or is missing as a dependency.","error":"ModuleNotFoundError: No module named 'face_recognition_models'"},{"fix":"Use models_path() as in the quickstart.","cause":"Trying to use a relative path instead of using models_path() to locate the model.","error":"FileNotFoundError: [Errno 2] No such file or directory: 'dlib_face_recognition_resnet_model_v1.dat'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}