https://github.com/derhnyel/emoplay
A flask application for face detection and emotion recognition.
https://github.com/derhnyel/emoplay
flask python
Last synced: 6 months ago
JSON representation
A flask application for face detection and emotion recognition.
- Host: GitHub
- URL: https://github.com/derhnyel/emoplay
- Owner: derhnyel
- License: mit
- Created: 2021-11-09T21:31:55.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-02-08T12:56:54.000Z (over 4 years ago)
- Last Synced: 2025-02-01T20:45:13.306Z (over 1 year ago)
- Topics: flask, python
- Language: Python
- Homepage: https://emoplay.herokuapp.com/
- Size: 24.1 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://heroku.com/deploy?template=https://github.com/AbirHasan2005/GdriveSearcherBot)
PLAYEMO
Playemo was built from the ground-up with Flask, a python tool that makes it easy for developers to build APIs.
## Use Cases
**Is Python your language of choice?** If so, we have a [fully-supported Python API client] that makes working with the playemo API an easy task!
There are many reasons to use the playemo API. The most common use case is to predict the emotion of a person from a single photograph.
However, this can also be used as a facial detection engine which returns a cropped out image of the face detected in a single photograph.!
## Authorization
All API requests require the use of an API key
To authenticate an API request, you should provide your the `api_key=[API_KEY]` as a GET parameter to authorize yourself to the API. But note that this is likely to leave traces in things like your history, if accessing the API through a browser.
```http
GET /?api_key=12345678901234567890123456789012
```
| Parameter | Type | Description |
| :--- | :--- | :--- |
| `api_key` | `string` | **Required**. Your Playemo API key |
## Responses
Many API endpoints return the JSON representation of the resources created or edited. However, if an invalid request is submitted, or some other error occurs, Playemo returns a JSON response in the following format:
```javascript
{
"error" : string,
"success" : bool,
"result" : string
}
```
The `error` attribute contains a message commonly used to indicate errors or, in the case of deleting a resource, success that the resource was properly deleted.
The `success` attribute describes if the transaction was successful or not.
The `result` attribute contains any other metadata associated with the response. This will be an escaped string containing JSON data.
## Status Codes
Playemo returns the following status codes in its API:
| Status Code | Description |
| :--- | :--- |
| 200 | `OK` |
| 201 | `CREATED` |
| 400 | `BAD REQUEST` |
| 404 | `NOT FOUND` |
| 500 | `INTERNAL SERVER ERROR` |
## Links
Please don't hesitate to [file an issue](https://github.com/playemo_api/issues/new) if you see anything missing.
- [Repo](https://github.com/derhnyel/playemo_api "playemo_api Repo")
- [Live](https://emoplay.herokuapp.com "Live View")
- [Bugs](https://github.com/derhnyel/playemo_api/issues "Issues Page")
## Screenshots
## Available Commands
In the project directory, you can run:
`python--version" : "check python version"`,
Since tensorflow supports python 3.7,3.6,3.5 or 3.4, i would advice you have python 3.6 installed on your machine.
### `pip install -r requirements.txt" : "required libaries installed"`,
This will install the the neccesarry libaries needed to run the application on your machine.
### `python app.py" : "python-scripts start"`,
The app is built using `Flask` so this command Runs the app in Development mode. Open [http://localhost:5000](http://localhost:5000) to view it in the browser. The page will reload if you make edits.
You will also see any lint errors in the console.
## Built With
- Python
- Flask
- Mtcnn
- TensorFlow
- Keras
- CSS
- HTML
## Future Updates
- A playlist recommendation system based on Emotion predicted
## Author
**DERHNYEL**
- [Profile](https://github.com/derhnyel "Eje Daniel")
- [Email](mailto:ejedenials@gmail.com?subject=Hi "Hi!")
- [Website](https://daniel-eje.herokuapp.com "Welcome")
## 🤝 Support
Contributions, issues, and feature requests are welcome!
Give a ⭐️ if you like this project!