Visão Enviado 2026

PyOpenCV FaceRec

Reconhecimento facial LBPH com interface CustomTkinter e operação via CLI

Stack Tecnológica

Python OpenCV CustomTkinter NumPy
Ver Código Voltar ao Bestiário

PyOpenCV FaceRec

Sistema completo de reconhecimento facial com o algoritmo LBPH (Local Binary Patterns Histograms) do OpenCV. Permite cadastrar usuários, coletar amostras faciais, treinar o modelo e reconhecer rostos em tempo real.

O software oferece duas interfaces que compartilham a mesma base de dados:

  1. GUI — aplicação moderna com CustomTkinter.
  2. CLI — scripts de terminal para operações rápidas ou ambientes sem interface gráfica.

Funcionalidades

  • Cadastro — insere o nome e gera automaticamente um ID único em usuarios.json.
  • Coleta de faces — captura automaticamente 30 imagens do rosto detectado pela webcam, salvando em dataset/.
  • Treinamento — processa o dataset e atualiza o modelo trainer.yml.
  • Reconhecimento em tempo real — identifica o rosto e exibe nome e nível de confiança.

Interface gráfica

python gui_app.py

A GUI centraliza todas as etapas em um único app: início, cadastro, coleta, treinamento e reconhecimento.

Linha de comando

Orquestrador main.py com os comandos novo, coleta, treino e run:

python main.py novo
python main.py coleta
python main.py treino
python main.py run

No reconhecimento, pressione ESC para sair.

Estrutura

  • gui_app.py — interface gráfica.
  • main.py — orquestrador da CLI.
  • 00_cadastro.py — cadastro de usuários.
  • 01_coleta.py — coleta de amostras faciais.
  • 02_treinamento.py — treinamento do modelo LBPH.
  • 03_reconhecimento.py — reconhecimento em tempo real.
  • usuarios.json — mapeamento local de nomes para IDs.
  • trainer.yml — modelo treinado.
  • dataset/ — imagens capturadas.

Detalhes técnicos

  • LBPH — robusto a variações de iluminação e adequado a datasets pequenos.
  • Persistência compartilhada — GUI e CLI operam sobre os mesmos arquivos; alterações em uma refletem imediatamente na outra.
  • IDs numéricos — o reconhecimento usa IDs internamente e faz o mapeamento reverso para nomes consultando o JSON em tempo de execução.

Instalação

pip install opencv-python opencv-contrib-python numpy Pillow customtkinter

Ou:

pip install -r requirements.txt