{"id":24576128,"url":"https://github.com/zviniicius/ml_facerecognition","last_synced_at":"2026-05-09T19:13:59.005Z","repository":{"id":270438756,"uuid":"910383867","full_name":"zViniicius/ML_FaceRecognition","owner":"zViniicius","description":"Este projeto realiza o reconhecimento de rostos em imagens utilizando a biblioteca face_recognition em conjunto com OpenCV.","archived":false,"fork":false,"pushed_at":"2024-12-31T06:17:29.000Z","size":447,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T22:23:20.659Z","etag":null,"topics":["face-recognition","opencv","python"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zViniicius.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-31T06:09:00.000Z","updated_at":"2024-12-31T06:17:32.000Z","dependencies_parsed_at":"2024-12-31T07:31:13.101Z","dependency_job_id":null,"html_url":"https://github.com/zViniicius/ML_FaceRecognition","commit_stats":null,"previous_names":["zviniicius/ml_facerecognition"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zViniicius%2FML_FaceRecognition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zViniicius%2FML_FaceRecognition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zViniicius%2FML_FaceRecognition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zViniicius%2FML_FaceRecognition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zViniicius","download_url":"https://codeload.github.com/zViniicius/ML_FaceRecognition/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244036185,"owners_count":20387469,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["face-recognition","opencv","python"],"created_at":"2025-01-23T22:21:48.106Z","updated_at":"2026-05-09T19:13:58.959Z","avatar_url":"https://github.com/zViniicius.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Projeto de Reconhecimento Facial\n\nEste projeto realiza o reconhecimento de rostos em imagens utilizando a biblioteca `face_recognition` em conjunto com `OpenCV`. O objetivo é identificar personagens a partir de suas imagens e gerar uma imagem anotada com os rostos detectados e seus respectivos nomes.\n\n## Funcionalidade\n\n- O projeto carrega imagens de personagens conhecidos e gera codificações de rostos a partir dessas imagens.\n- Ele então reconhece os rostos presentes em uma imagem de entrada e os compara com os rostos conhecidos.\n- A imagem de entrada é anotada com caixas delimitadoras e os nomes dos personagens reconhecidos.\n- O sistema também conta quantos rostos foram reconhecidos e quantos foram classificados como \"Desconhecidos\".\n\n## Requisitos\n\nCertifique-se de que o Python está instalado no seu ambiente. Este projeto depende das seguintes bibliotecas:\n\n- `face_recognition`: Para reconhecimento facial.\n- `face_recognition_models`: Modelos pré-treinados para reconhecimento facial.\n- `opencv-python`: Para manipulação de imagens.\n- `numpy`: Para manipulação de arrays.\n\n### Instalando as Dependências\n\nSe você ainda não tem as dependências instaladas, pode instalar todas as bibliotecas necessárias com o seguinte comando:\n\n```bash\npip install -r requirements.txt\n```\n\n## Estrutura do Projeto\n\n```\n/seu-projeto\n│\n├── assets\n│   └── images\n│       ├── personagem1.jpg\n│       ├── personagem2.jpg\n│       └── ... (imagens dos personagens)\n│\n├── input\n│   └── image.jpg  # Imagem para reconhecimento\n│\n├── output\n│   └── recognized_faces_out.jpg  # Imagem de saída com as anotações\n│\n├── requirements.txt  # Dependências do projeto\n└── recognition.py  # Código principal do projeto\n```\n\n## Como Usar\n\n1. **Preparar Imagens dos Personagens**:\n   Coloque as imagens dos personagens conhecidos na pasta `assets/images`. O nome de cada imagem deve corresponder ao nome do personagem (sem a \n   extensão). Exemplo: `Harry.jpg`, `Ron.jpg`, etc.\n\n2. **Adicionar Imagem de Entrada**:\n   Coloque a imagem onde você deseja realizar o reconhecimento na pasta `input` (por exemplo, `elenco.jpg`).\n\n3. **Executar o Script**:\n   Execute o script Python para realizar o reconhecimento de rostos:\n\n   ```bash\n   python recognition.py\n   ```\n\n   O script irá processar a imagem de entrada e gerar uma imagem de saída com as caixas delimitadoras e os nomes dos rostos detectados. A imagem anotada será salva na pasta `output` como `recognized_faces_out.jpg`.\n\n4. **Estatísticas**:\n   O script também exibirá as seguintes estatísticas no terminal:\n    - Quantos rostos foram reconhecidos.\n    - Quantos rostos foram classificados como \"Desconhecidos\".\n\n### Exemplo de Saída\n\nAo executar o script, você verá uma saída como:\n\n```bash\nRostos reconhecidos: 4\nRostos desconhecidos: 2\nImagem anotada salva em: output/recognized_faces_out.jpg\n```\n\nIsso significa que 4 rostos foram reconhecidos como personagens conhecidos e 2 rostos foram classificados como desconhecidos.\n\n\n## Contribuições\n\nEste é um projeto de código aberto! Fique à vontade para contribuir, corrigir bugs ou melhorar a funcionalidade. Se você deseja contribuir, crie um fork do repositório, faça suas alterações e envie um pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzviniicius%2Fml_facerecognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzviniicius%2Fml_facerecognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzviniicius%2Fml_facerecognition/lists"}