Repolode
Enviar
serengil

serengil/deepface

Biblioteca Python para reconhecimento facial e análise de atributos, como idade, gênero, emoção e raça, com vários modelos e detectores intercambiáveis.

Ver no GitHubSite
Estrelas
23,650
Forks
3,211
Issues abertas
4
Último commit
há 21 horas

O que é?

DeepFace é um framework Python para reconhecimento facial e análise de atributos faciais. Ele reúne vários modelos de reconhecimento facial, incluindo VGG-Face, FaceNet, ArcFace, OpenFace e SFace, além de diversos detectores faciais, como OpenCV, RetinaFace, MTCNN, MediaPipe e variantes do YOLO. Desenvolvedores podem chamar funções de alto nível, como verify, find, analyze e represent, em uma única linha, enquanto a biblioteca cuida da detecção, do alinhamento, da normalização e da comparação de vetores em segundo plano.

Além da verificação um a um e da busca em pastas, o DeepFace oferece cadastro e busca com suporte de bancos de dados por meio de backends como PostgreSQL, pgvector, MongoDB, Redis e Qdrant, com busca opcional por vizinhos mais próximos aproximados. Também oferece transmissão em tempo real pela webcam, verificações anti-spoofing e uma API REST e gRPC que pode ser executada diretamente ou no Docker. O mecanismo de inferência padrão é o ONNX Runtime, com TensorFlow e PyTorch disponíveis como extras opcionais.

Recursos principais

  • 01Verificação facial e busca facial 1:N em pastas ou bancos de dados.
  • 02Análise de atributos como idade, gênero, emoção e raça.
  • 03Vários modelos de reconhecimento e backends de detecção, selecionáveis por argumento.
  • 04Transmissão em tempo real pela webcam, com reconhecimento e análise de atributos.
  • 05Verificação anti-spoofing opcional para detectar rostos falsos.
  • 06Servidores de API REST e gRPC, com suporte a Docker.

Casos de uso

  • Implementar login facial ou verificação de identidade em uma aplicação Python.
  • Buscar uma pessoa específica em uma coleção de fotos.
  • Executar análise facial como microsserviço chamado por um app web ou móvel.
  • Criar protótipos de projetos de visão computacional que precisam de embeddings faciais.

Início rápido

  1. 1

    Instale a biblioteca pelo PyPI (o backend padrão é o ONNX Runtime)

    pip install deepface
  2. 2

    Importe a biblioteca no Python

    from deepface import DeepFace
  3. 3

    Verifique se duas imagens de rostos mostram a mesma pessoa

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

Antes de usar

  • O reconhecimento facial e a análise de atributos levantam questões de privacidade e ética; verifique as leis aplicáveis no local onde você fizer a implantação.
  • Os backends completos do TensorFlow ou do PyTorch adicionam de um a vários GB de dependências.

Em coleções

Bibliotecas e ferramentas de visão computacional

Tópicos

#face-recognition#computer-vision#deep-learning#facial-analysis#python#embeddings#vector-search#age-prediction#arcface#deepface

Perguntas frequentes

O que é deepface?
Biblioteca Python para reconhecimento facial e análise de atributos, como idade, gênero, emoção e raça, com vários modelos e detectores intercambiáveis. DeepFace é um framework Python para reconhecimento facial e análise de atributos faciais. Ele reúne vários modelos de reconhecimento facial, incluindo VGG-Face, FaceNet, ArcFace, OpenFace e SFace, além de diversos detectores faciais, como OpenCV, RetinaFace, MTCNN, MediaPipe e variantes do YOLO. Desenvolvedores podem chamar funções de alto nível, como verify, find, analyze e represent, em uma única linha, enquanto a biblioteca cuida da detecção, do alinhamento, da normalização e da comparação de vetores em segundo plano.
deepface é gratuito? Qual é a licença?
deepface é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
deepface ainda é mantido?
Manutenção ativa. O último commit de deepface foi em 5 de nov. de 2026.
Para que posso usar deepface?
Implementar login facial ou verificação de identidade em uma aplicação Python. Buscar uma pessoa específica em uma coleção de fotos. Executar análise facial como microsserviço chamado por um app web ou móvel. Criar protótipos de projetos de visão computacional que precisam de embeddings faciais.
Como instalar deepface?
Instale a biblioteca pelo PyPI (o backend padrão é o ONNX Runtime): pip install deepface Importe a biblioteca no Python: from deepface import DeepFace Verifique se duas imagens de rostos mostram a mesma pessoa: result: dict = DeepFace.verify(img1_path = "img1.jpg", img2_path = "img2.jpg")
Onde consigo deepface?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/serengil/deepface

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados