https://github.com/omatheusribeiro/facial-recognition
The Facial Recognition project is a powerful system designed to detect facial expressions, recognize faces, and estimate age using the face-api library.
https://github.com/omatheusribeiro/facial-recognition
css faceapi facial-recognition front-end front-end-development frontend html html-css html-css-javascript javascript javascript-es6 reconhecimento-de-voz reconhecimento-facial speech-recognition
Last synced: 3 months ago
JSON representation
The Facial Recognition project is a powerful system designed to detect facial expressions, recognize faces, and estimate age using the face-api library.
- Host: GitHub
- URL: https://github.com/omatheusribeiro/facial-recognition
- Owner: omatheusribeiro
- License: bsd-3-clause
- Created: 2022-04-05T16:45:34.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-02T00:32:24.000Z (4 months ago)
- Last Synced: 2025-03-02T01:25:28.755Z (4 months ago)
- Topics: css, faceapi, facial-recognition, front-end, front-end-development, frontend, html, html-css, html-css-javascript, javascript, javascript-es6, reconhecimento-de-voz, reconhecimento-facial, speech-recognition
- Language: CSS
- Homepage:
- Size: 10.6 MB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 Facial Recognition System
## 📌 Overview
The **Facial Recognition** project is a powerful system designed to detect facial expressions, recognize faces, and estimate age using the **face-api** library. 🚀
This repository contains an implementation of:
✅ **Facial Expression Recognition** 😊😡😢
✅ **Facial Recognition** 🧑🔍
✅ **Age Estimation** 🎯
## 📝 Description
The aim of this project is to demonstrate the usage of the **face-api** library to perform facial expression recognition, facial recognition, and age estimation in images or videos. **face-api** is an open-source JavaScript library that enables real-time face detection and analysis.
## 🏗️ Project Structure
```
facial-recognition
├── assets/ # Assets such as images or models
├── css/
│ └── styles.css # CSS for styling the interface
├── js/
│ └── app.js # JavaScript logic for face detection and analysis
├── lib/
│ └── face-api/ # face-api library files
└── index.html # Main HTML file
```
## 🚀 Getting Started
### 📋 Prerequisites
Ensure you have the following installed:
- [Node.js](https://nodejs.org/) (optional, for local server setup)
- Modern web browser (Chrome, Firefox, etc.)
- Live Server Extension for VS Code (recommended) ⚡
### 🔧 Installation
```bash
# Clone the repository
git clone https://github.com/omatheusribeiro/facial-recognition.git
cd facial-recognition
```
### ▶️ Running the Project
#### Using Live Server in VS Code (Recommended)
1. Install the **Live Server** extension in VS Code:
- Open VS Code.
- Go to the Extensions tab (`Ctrl+Shift+X` or `Cmd+Shift+X` on Mac).
- Search for "Live Server" and install it.
2. Open the project folder in VS Code.
3. Right-click on `index.html` and select **'Open with Live Server'**.
4. The project will open automatically in your browser at **http://127.0.0.1:5500/index.html** 🚀
#### Alternative Methods
If you prefer using a simple local server:
```bash
# Using a simple Python server
python -m http.server
# Or using Node.js
npx http-server
```
Then go to: **http://127.0.0.1:8000/index.html** (or the displayed port).
## ⚙️ How It Works
1. Upload an image or enable your webcam.
2. The system detects faces in real-time.
3. It analyzes facial features to identify expressions, recognize identities, and estimate age.
## 🛠️ Technologies Used
- **HTML & CSS**
- **JavaScript & TypeScript**
- **face-api.js** (for facial recognition and analysis)
## 📜 License
This project is licensed under the BSD 3-Clause License.