explaingit

terrabyte-dev/hinge-auto

Analysis updated 2026-05-18

23PythonAudience · developerComplexity · 4/5Setup · hard

TLDR

An experimental Android-emulator bot that uses AI vision to judge Hinge dating profiles and write openers, explicitly against Hinge's Terms of Service.

Mindmap

mindmap
  root((HingeAuto))
    Automation Loop
      Android Emulator
      ADB Screenshots
      Tap and Scroll
    AI Judging
      User Written Rubric
      Claude API Option
      Local Ollama Option
    Actions
      Skip Profile
      Like and Message
      Personalized Opener
    Profile Review
      scan_self Script
      Markdown Report
    Risk
      Violates Hinge ToS
      Ban Risk

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Explore how to combine screen automation, computer vision, and an AI judge into a working phone-app control loop, as an engineering exercise.

USE CASE 2

Automatically screenshot and evaluate dating profiles against a rubric you write, then like or skip them.

USE CASE 3

Generate a personalized opening message in a configured voice when a profile is liked.

USE CASE 4

Analyze your own dating profile with scan_self.py and get a Markdown report with photo and prompt suggestions.

What is it built with?

PythonADBAndroid StudioClaude APIOllama

How does it compare?

terrabyte-dev/hinge-autoaaravkashyap12/advise-project-approachabu-rayhan-alif/django-saas-kit
Stars232323
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Android Studio, a configured emulator, ADB, and either a paid Claude API key or a locally running Ollama model, violates Hinge's Terms of Service.

In plain English

HingeAuto is an experimental tool that automates the Hinge dating app by running it inside an Android emulator on your computer and using an AI model to make decisions about each profile. The README opens with a clear warning: this violates Hinge's Terms of Service and carries a real risk of a permanent account ban with no appeal. The project is described as an educational exercise in connecting computer vision and AI judgment to a phone app interface, not as practical dating advice. The setup involves installing Android Studio, creating a virtual Android device, and installing Hinge on it the same way you would on a real phone. Once the emulator is running, the project uses ADB (the standard Android debugging tool) to take screenshots and send tap and scroll commands to the emulator's screen. For each profile the bot encounters, it scrolls from top to bottom, captures the screen, and sends the images to an AI model along with a rubric you write yourself. The rubric is a plain-text file called a mode that describes what should and should not receive a like. Based on the AI's judgment, the bot either taps Skip or taps the heart and asks the AI to write a personalized opening message in a voice you configure. Two AI options are supported: the Claude API (paid, higher quality) or a locally running Ollama model (free, lower quality). The README estimates roughly $0.25 per day using Claude at the free-tier like cap of 8 profiles. A separate script called scan_self.py uses the same screenshot-and-AI approach on your own profile, the view other users actually see, and writes a Markdown report with specific suggestions for photos and prompts. The README notes this is the only feature that does not touch swiping or messaging and is therefore the one part that does not violate Hinge's terms. Calibration scripts handle differences between emulator screen sizes if your setup uses a different device than the default Pixel 10 at 1080 by 2424 resolution.

Copy-paste prompts

Prompt 1
Help me set up the Android emulator and adb connection this project needs before running anything.
Prompt 2
Explain how this project uses ADB to screenshot a profile and send tap and scroll commands to the emulator.
Prompt 3
Walk me through writing a rubric mode file that tells the AI what should and should not receive a like.
Prompt 4
Show me the difference between using the Claude API and a local Ollama model for judging profiles in this repo.
Prompt 5
I only want to use scan_self.py to get feedback on my own profile. Show me how to run just that script safely.

Frequently asked questions

What is hinge-auto?

An experimental Android-emulator bot that uses AI vision to judge Hinge dating profiles and write openers, explicitly against Hinge's Terms of Service.

What language is hinge-auto written in?

Mainly Python. The stack also includes Python, ADB, Android Studio.

How hard is hinge-auto to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is hinge-auto for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.