Base de conocimiento de videos autohospedada y local-first que transcribe y analiza los fotogramas de tus videos, genera embeddings y permite buscar escenas en lenguaje natural.
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
Instala la biblioteca desde PyPI (ONNX Runtime es el backend predeterminado)
pip install deepface - 2
Importa la biblioteca en Python
from deepface import DeepFace - 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
Una biblioteca unificada de Python para detección, reconocimiento y seguimiento facial, landmarks, parsing, estimación de la mirada, atributos y anti-spoofing mediante una sola API.
Biblioteca de Python para aprendizaje autosupervisado con imágenes, con componentes de PyTorch para entrenar modelos de visión sin etiquetas.
Toolkit ligero de C++ con más de 100 modelos de IA para detección, reconocimiento facial, segmentación y matting, compatible con ONNXRuntime, MNN, TensorRT y otros.
Software NVR y de visión artificial con IA, autohospedado y totalmente local, para detectar objetos, movimiento y rostros en tus propias cámaras.
Una app de escritorio que prioriza la privacidad y organiza tus fotos por rostros, fecha y ubicación, totalmente offline en Windows y macOS.