deepface: Lightweight Face Recognition and Facial Attribute Analysis Library
This repository profile is provided by osrepos.com, an open source repository discovery platform.
Summary
deepface is a powerful yet lightweight Python library for face recognition and facial attribute analysis. It offers capabilities for age, gender, emotion, and race prediction, wrapping state-of-the-art models for robust performance. Developers can easily integrate advanced facial analysis into their applications with just a few lines of code.
Repository Information
Topics
Click on any tag to explore related repositories
Use at your own risk
OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.
Introduction
deepface is a robust and lightweight Python library designed for advanced face recognition and comprehensive facial attribute analysis. It empowers developers to easily implement functionalities like age, gender, emotion, and race prediction. This hybrid framework integrates and wraps several state-of-the-art deep learning models, including VGG-Face, FaceNet, OpenFace, ArcFace, and DeepFace, ensuring high accuracy and flexibility. It simplifies the complex pipeline of face detection, alignment, normalization, representation, and verification, allowing users to perform sophisticated facial analysis with minimal code.
Installation
Getting started with deepface is straightforward. The easiest way to install the library and its prerequisites is via pip:
$ pip install deepface
Alternatively, you can install it from the source code to access the latest features:
$ git clone https://github.com/serengil/deepface.git
$ cd deepface
$ pip install -e .
Once installed, you can import and use deepface functionalities:
from deepface import DeepFace
Examples
deepface provides a simple API for various facial analysis tasks:
Face Verification
Determine if two facial images belong to the same person. The verify function returns a dictionary, with verified indicating the result and a confidence score.
result = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")
Face Recognition
Identify a person from a database of faces. The find function searches for the identity of an input image within a specified database path, returning a list of pandas DataFrames.
dfs = DeepFace.find(img_path = "img1.jpg", db_path = "C:/my_db")
Facial Attribute Analysis
Analyze facial attributes such as age, gender, emotion, and race. The analyze function provides detailed predictions for each detected face.
objs = DeepFace.analyze(
img_path = "img4.jpg", actions = ['age', 'gender', 'race', 'emotion']
)
Real-Time Analysis
Perform real-time face recognition and attribute analysis using a webcam. The stream function accesses your webcam and processes frames sequentially.
DeepFace.stream(db_path = "C:/database")
Embeddings
Extract multi-dimensional vector embeddings from facial images. These embeddings are crucial for similarity comparisons and can be obtained using the represent function.
embedding_objs = DeepFace.represent(img_path = "img.jpg")
Why Use deepface
deepface stands out for its comprehensive feature set and ease of use. It wraps numerous state-of-the-art face recognition models and detection backends, offering unparalleled flexibility and performance. Whether you need to verify identities, recognize faces in a database, or analyze facial attributes in real-time, deepface provides a robust and efficient solution. Its modular design allows for customization of models, detectors, and distance metrics, making it adaptable to various application requirements, from small-scale projects to large-scale facial recognition systems with vector databases and homomorphic encryption.
Links
Related repositories
Similar repositories that may be relevant next.

DA-Forge: Streamlining Declarative Agent Creation for Copilot Notebooks
September 12, 2026
DA-Forge is a Python-based tool by Microsoft designed to automate the creation and deployment of Declarative Agents for Copilot Notebooks. It significantly reduces the manual effort and time required to set up AI assistants with specific grounding references, transforming an 85-minute process into just a few minutes. This tool is essential for developers and researchers working with Copilot Notebooks and Declarative Agents.

Curie: Automated and Rigorous Scientific Experimentation with AI Agents
September 12, 2026
Curie is an innovative AI-agent framework designed for automating rigorous scientific experimentation. It streamlines the entire research lifecycle, from hypothesis formulation to result interpretation, ensuring precision, reliability, and reproducibility. This empowers scientists to accelerate their research processes significantly.

Tau: A Minimalist Python Coding Agent for Your Terminal
September 8, 2026
Tau is a Python port of Pi's minimalist coding agent, designed to live in your terminal. It allows users to make requests like "explain this repo" or "add tests," and it can read files, edit code, and run commands. Beyond its utility, Tau also serves as a teaching project, demonstrating how coding agents are built with a small, readable codebase.

Awesome Harness Engineering: Building Reliable AI Agent Systems
September 7, 2026
Awesome Harness Engineering is a comprehensive curated list dedicated to the discipline of designing robust AI agent harnesses. It offers a wealth of resources, patterns, and templates essential for building reliable AI agent systems. Developers can explore tools, best practices, and foundational concepts across various critical areas of agent development.
Source repository
Open the original repository on GitHub.
17 counted GitHub visits