---
id: deepface
version: "0.0.100"
license: MIT
license_treatment: permissive
maintenance: active
---

# deepface — A Lightweight Face Recognition and Facial Attribute Analysis Framework (Age, Gender, Emotion, Race) for Python

License: permissive · Maintenance: active · Downloads: 587.6K/mo

## What it is and what it does

DeepFace is a Python framework that wraps multiple state-of-the-art face recognition and analysis models (VGG-Face, FaceNet, OpenFace, DeepFace, DeepID, ArcFace, Dlib, SFace, GhostFaceNet, Buffalo_L) into a unified API. It handles the full face recognition pipeline—detection, alignment, normalization, representation, and verification—internally, so you can call high-level functions like `verify()`, `find()`, or `analyze()` with minimal setup.

The package supports three main workflows: one-to-one face verification (comparing two images), one-to-many face recognition (searching a database of embeddings stored in PostgreSQL, MongoDB, Neo4j, Pinecone, pgvector, or Weaviate), and facial attribute analysis (predicting age, gender, emotion, and race from images). It also includes real-time video streaming for continuous analysis. With 18 runtime dependencies including TensorFlow, Keras, OpenCV, and Flask, it brings substantial computational machinery but abstracts away the complexity of model selection and pipeline orchestration.

Use it for:

- Verify whether two photos belong to the same person for identity confirmation or fraud detection workflows.
- Search a database of employee or customer photos to identify individuals in new images for security or CRM applications.
- Analyze facial attributes (age, gender, emotion, race) in batch or real-time video for demographic insights or sentiment analysis.
- Build a real-time video stream analyzer that continuously detects and identifies faces from a webcam feed.
- Register and index face embeddings in a vector database for large-scale face recognition at scale.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

DeepFace performs face recognition, verification, and facial attribute analysis (age, gender, emotion, race) using deep learning models, with support for real-time video streams and large-scale database searches.

Yes, if you need face recognition or facial attribute analysis and can accept the substantial dependency footprint (TensorFlow, Keras, OpenCV). The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and abstracts away significant complexity. Install it if your use case justifies the disk and memory overhead; avoid it if you need a lightweight, minimal-dependency solution or are uncertain whether you need deep learning-based face analysis.

## Install

pip install deepface
uv add deepface
poetry add deepface

## Installing deepface

Before you install: Low install friction with a pure Python wheel. Depends on 18 runtime packages including TensorFlow, Keras, and OpenCV, which may require significant disk space and compilation time on some systems. The project is actively maintained with recent commits and high GitHub visibility.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license notice.

Quickstart:

pip install deepface

from deepface import DeepFace

# Face verification
result = DeepFace.verify(img1_path="img1.jpg", img2_path="img2.jpg")

# Facial attribute analysis
objs = DeepFace.analyze(img_path="img.jpg", actions=['age', 'gender', 'emotion', 'race'])

Requires TensorFlow and Keras; pre-trained models are downloaded on first use. OpenCV and Pillow need system libraries for image handling.

Verify before relying:

- Whether pre-trained model downloads are cached or re-downloaded on each environment setup
- GPU acceleration support and CUDA/cuDNN requirements for production deployments
- Latency and throughput characteristics for real-time streaming on typical hardware
- Accuracy metrics for the supported models beyond the age MAE and gender accuracy cited in the description

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 587.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

face recognition python, facial attribute analysis, age gender emotion detection, face verification matching, face detection deep learning, real-time face analysis, face database search, face-recognition, computer-vision, deep-learning

[View on SkillFed](https://skillfed.io/packages/deepface) · [View on PyPI](https://pypi.org/project/deepface/)