by hfreire

hfreire / get-me-a-date

:heart_eyes: Help me get a :cupid: date tonight :first_quarter_moon_with_face:

215 Stars 34 Forks Last release: 5 days ago (v1.3.695) MIT License 3.2K Commits 881 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

:hearteyes: Help me get a :cupid: date tonight :firstquartermoonwith_face:

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 :whitecheckmark:
  • Supports Happn dating app :whitecheckmark:
  • Supports Mint dating app :whitecheckmark:
  • Uses your existing matches :revolvinghearts: for machine-learning :robot: when to :+1: or :-1: new recommendations :whitecheck_mark:
  • Periodically :clock10: gets dating app :girl::woman: recommendations and automatically :robot: :+1: or :-1: :whitecheckmark:
  • Launch :rocket: inside a Docker container :whale: so you don't need to manage the dependencies :raisedhands: :whitecheck_mark:

How to use

Use it in your terminal

Run the Docker image in a container exposing the port

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

Available REST API endpoints

Swagger documentation available at


Available environment variables


Description Required Default value
FACEBOOKUSEREMAIL Facebook user e-mail address used for login. true

FACEBOOKUSERPASSWORD Facebook user password used for login. true
AWSREGION AWS region used for S3 and Rekognition. true
AWSACCESSKEYID AWS access key used for S3 and Rekognition. true
AWSSECRETACCESSKEY AWS secret access key used for S3 and Rekognition. true
FINDDATESPERIOD The time period (in seconds) between finding dates. false
PORT The port to be used by the HTTP server. false
APIKEYS The secret keys that should be used when securing endpoints. false
SOTIMEOUT TCP socket connection timeout. false
LOGLEVEL The log level verbosity. false
ENVIRONMENT The environment the app is running on. false
ROLLBARAPIKEY The server API key used to talk with Rollbar. false

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.