Awesome Open Source
Awesome Open Source

😍 Help me get a πŸ’˜ date tonight πŸŒ›

Coverage Status Known Vulnerabilities Docker Stars Docker Pulls

Uses AWS Rekognition deep learning-based image recognition to help you automate your date discovery.


  • Supports Tinder dating app βœ…
  • Supports Happn dating app βœ…
  • Supports Mint dating app βœ…
  • Uses your existing matches πŸ’ž for machine-learning πŸ€– when to πŸ‘ or πŸ‘Ž new recommendations βœ…
  • Periodically πŸ•™ gets dating app πŸ‘§πŸ‘© recommendations and automatically πŸ€– πŸ‘ or πŸ‘Ž βœ…
  • Launch πŸš€ inside a Docker container 🐳 so you don't need to manage the dependencies πŸ™Œ βœ…

How to use

Use it in your terminal

Run the Docker image in a container exposing the port 5940

docker run -d -p "5940:3000" hfreire/get-me-a-date

Available REST API endpoints

Swagger documentation available at http://localhost:5940/docs.

Available environment variables

Variable Description Required Default value
FACEBOOK_USER_EMAIL Facebook user e-mail address used for login. true undefined
FACEBOOK_USER_PASSWORD Facebook user password used for login. true undefined
AWS_REGION AWS region used for S3 and Rekognition. true undefined
AWS_ACCESS_KEY_ID AWS access key used for S3 and Rekognition. true undefined
AWS_SECRET_ACCESS_KEY AWS secret access key used for S3 and Rekognition. true undefined
FIND_DATES_PERIOD The time period (in seconds) between finding dates. false 600
PORT The port to be used by the HTTP server. false 3000
API_KEYS The secret keys that should be used when securing endpoints. false undefined
SO_TIMEOUT TCP socket connection timeout. false 120000
LOG_LEVEL The log level verbosity. false info
ENVIRONMENT The environment the app is running on. false undefined
ROLLBAR_API_KEY The server API key used to talk with Rollbar. false undefined

How to build

Clone the GitHub repo

git clone

Change current directory

cd get-me-a-date

Run the NPM script that will build the Docker image

npm run build

How to contribute

You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.

All donation proceedings will go to the Sverige fΓΆr UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.


Read the license for permissions and limitations.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,539,835)Β 
Docker (33,306)Β 
Bot (11,903)Β 
Aws (10,961)Β 
Ai (4,565)Β 
Github Actions (3,796)Β 
Face Recognition (1,572)Β 
Facial Recognition (247)Β 
Love (180)Β 
Tinder (170)Β 
Related Projects
Advertising πŸ“¦Β 9
All Projects
Application Programming Interfaces πŸ“¦Β 120
Applications πŸ“¦Β 181
Artificial Intelligence πŸ“¦Β 72
Blockchain πŸ“¦Β 70
Build Tools πŸ“¦Β 111
Cloud Computing πŸ“¦Β 79
Code Quality πŸ“¦Β 28
Collaboration πŸ“¦Β 30
Command Line Interface πŸ“¦Β 48
Community πŸ“¦Β 81
Companies πŸ“¦Β 60
Compilers πŸ“¦Β 60
Computer Science πŸ“¦Β 74
Configuration Management πŸ“¦Β 39
Content Management πŸ“¦Β 167
Control Flow πŸ“¦Β 197
Data Formats πŸ“¦Β 77
Data Processing πŸ“¦Β 266
Data Storage πŸ“¦Β 132
Economics πŸ“¦Β 60
Frameworks πŸ“¦Β 198
Games πŸ“¦Β 122
Graphics πŸ“¦Β 103
Hardware πŸ“¦Β 148
Integrated Development Environments πŸ“¦Β 47
Learning Resources πŸ“¦Β 147
Legal πŸ“¦Β 28
Libraries πŸ“¦Β 119
Lists Of Projects πŸ“¦Β 21
Machine Learning πŸ“¦Β 336
Mapping πŸ“¦Β 61
Marketing πŸ“¦Β 15
Mathematics πŸ“¦Β 55
Media πŸ“¦Β 228
Messaging πŸ“¦Β 97
Networking πŸ“¦Β 304
Operating Systems πŸ“¦Β 84
Operations πŸ“¦Β 120
Package Managers πŸ“¦Β 52
Programming Languages πŸ“¦Β 229
Runtime Environments πŸ“¦Β 96
Science πŸ“¦Β 42
Security πŸ“¦Β 375
Social Media πŸ“¦Β 26
Software Architecture πŸ“¦Β 70
Software Development πŸ“¦Β 68
Software Performance πŸ“¦Β 57
Software Quality πŸ“¦Β 127
Text Editors πŸ“¦Β 45
Text Processing πŸ“¦Β 131
User Interface πŸ“¦Β 310
User Interface Components πŸ“¦Β 465
Version Control πŸ“¦Β 29
Virtualization πŸ“¦Β 68
Web Browsers πŸ“¦Β 38
Web Servers πŸ“¦Β 25
Web User Interface πŸ“¦Β 194