Repolode
serengil

serengil/deepface

Biblioteca de Python para reconocimiento facial y análisis de atributos faciales, como edad, género, emoción y raza, con varios modelos y detectores intercambiables.

Estrellas
23,653
Forks
3,210
Issues abiertos
4
Último commit
anteayer

¿Qué es?

DeepFace es un framework de Python para el reconocimiento facial y el análisis de atributos faciales. Integra varios modelos de reconocimiento facial, como VGG-Face, FaceNet, ArcFace, OpenFace y SFace, y distintos detectores faciales, como OpenCV, RetinaFace, MTCNN, MediaPipe y variantes de YOLO. Los desarrolladores pueden llamar a funciones de alto nivel como verify, find, analyze y represent en una sola línea, mientras la biblioteca se encarga en segundo plano de la detección, la alineación, la normalización y la comparación de vectores.

Además de la verificación uno a uno y la búsqueda en carpetas, DeepFace permite registrar y buscar rostros mediante backends conectados a bases de datos como PostgreSQL, pgvector, MongoDB, Redis y Qdrant, con búsqueda opcional de vecinos más cercanos aproximados. También ofrece streaming en tiempo real desde la webcam, comprobaciones anti-spoofing y una API REST y gRPC que puede ejecutarse directamente o en Docker. El motor de inferencia predeterminado es ONNX Runtime; TensorFlow y PyTorch están disponibles como extras opcionales.

Funciones clave

  • 01Verificación facial y búsqueda de rostros 1:N en carpetas o bases de datos.
  • 02Análisis de atributos como edad, género, emoción y raza.
  • 03Varios modelos de reconocimiento y backends de detección que se pueden cambiar mediante argumentos.
  • 04Streaming en tiempo real desde la webcam, con reconocimiento y análisis de atributos.
  • 05Comprobación anti-spoofing opcional para detectar rostros falsos.
  • 06Servidores de API REST y gRPC, con compatibilidad con Docker.

Casos de uso

  • Añadir una función de inicio de sesión facial o verificación de identidad a una aplicación de Python.
  • Buscar a una persona específica en una colección de fotos.
  • Ejecutar el análisis facial como microservicio al que pueda llamar una aplicación web o móvil.
  • Crear prototipos de proyectos de visión por computadora que necesiten embeddings faciales.

Inicio rápido

  1. 1

    Instala la biblioteca desde PyPI (ONNX Runtime es el backend predeterminado)

    pip install deepface
  2. 2

    Importa la biblioteca en Python

    from deepface import DeepFace
  3. 3

    Comprueba si en dos imágenes de rostros aparece la misma persona

    result: dict = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")

Antes de usarlo

  • El reconocimiento facial y el análisis de atributos plantean problemas de privacidad y ética; consulta la normativa del lugar donde lo implementes.
  • Los backends completos de TensorFlow o PyTorch añaden varios GB de dependencias.

En colecciones

Temas

Preguntas frecuentes

¿Qué es deepface?
Biblioteca de Python para reconocimiento facial y análisis de atributos faciales, como edad, género, emoción y raza, con varios modelos y detectores intercambiables. DeepFace es un framework de Python para el reconocimiento facial y el análisis de atributos faciales. Integra varios modelos de reconocimiento facial, como VGG-Face, FaceNet, ArcFace, OpenFace y SFace, y distintos detectores faciales, como OpenCV, RetinaFace, MTCNN, MediaPipe y variantes de YOLO. Los desarrolladores pueden llamar a funciones de alto nivel como verify, find, analyze y represent en una sola línea, mientras la biblioteca se encarga en segundo plano de la detección, la alineación, la normalización y la comparación de vectores.
¿deepface es gratuito? ¿Qué licencia tiene?
deepface es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿deepface sigue mantenido?
Mantenimiento activo. El último commit de deepface fue el 5 nov 2026.
¿Para qué puedo usar deepface?
Añadir una función de inicio de sesión facial o verificación de identidad a una aplicación de Python. Buscar a una persona específica en una colección de fotos. Ejecutar el análisis facial como microservicio al que pueda llamar una aplicación web o móvil. Crear prototipos de proyectos de visión por computadora que necesiten embeddings faciales.
¿Cómo se instala deepface?
Instala la biblioteca desde PyPI (ONNX Runtime es el backend predeterminado): pip install deepface Importa la biblioteca en Python: from deepface import DeepFace Comprueba si en dos imágenes de rostros aparece la misma persona: result: dict = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")
¿Dónde consigo deepface?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/serengil/deepface

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados