Facial-emotion-recognition-FastAPI-service

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • usage
3. Contributing
4. License
5. Contact

About The Project!

This repository aims to provide dockerized, convenient, easy deployable and scalable REST API for face detection and emotion recognition pipeline using FastAPI. Use the README.md to get started.

Built With

The important frameworks/libraries used in this project are listed below.

• Python
• pytorch
• OpenCV
• FastAPI
• Docker

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

• Docker

Download docker engine according to your OS. Windows Linux Mac

Usage

To run the API, after install docker, execute the following commands:

• Create Docker Image

docker build -t face_emotion_recognition:1.0 .

• Run Docker Container

 docker run -p 8000:8000 -d face_emotion_recognition:1.0 

• Start FastAPI Service

open the browser and write localhost:8000/docs in the url place to start Swagger UI

• Test The Service

Use the images below to work with the service.

1

2

3

4

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b features)
3. Commit your Changes (git commit -m 'Add some Features')
4. Push to the Branch (git push origin features)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

• Email : aliaminibagh@gmail.com
• Linkedin : https://www.linkedin.com/in/aliaminibagh/
• Project Link: Facial-emotion-recognition-FastAPI-service