tinder-ai 0.1.5

A Tinder bot SDK using Selenium and AI

TINDER-AI

❯ Build an AI dating bot

📌 Table of Contents

• Overview
• Setup
• Usage
  • Session
  • Openers
  • Replies
  • Auto-Swiping
• Messenger Service
• Disclaimer

---

🚀 Overview

Tinder-AI is a Tinder bot SDK using Selenium with undetected Chromedriver. It provides:

• Profile setup
• Proxy support
• Geolocation spoofing
• Automated swiping
• Chatbot integration (Openers & replies)

Use it to build your own AI dating assistant.

---

⚙️ Setup

Install the package

pip install tinder-ai

Copy the .env.example file to .env:

cp .env.example .env

Edit .env and fill in the required values.

---

🛠 Usage

Session: Set up a session

from tinder_ai import Settings, Session

settings = Settings()
messenger_service = MockMessengerService()
with Session(
	settings=settings,
	messenger_service=messenger_service
) as session:
	session.login(
		method=settings.get_login_method()
	)

Openers: Send a first message to all matches

session.handle_matches()

Replies: Auto-reply unread messages

session.handle_unread_messages()

Auto-Swiping: Swipe on profiles automatically

session.start_swiping()

Messenger Service

Option 1: Using an API

Plug in your own LLM service to use for messaging.

messenger_service = MessengerService(
	base_url="http://0.0.0.0:8080"
)
session = Session(
	settings=settings,
	messenger_service=messenger_service
)

Option 2: Using a custom class

Inherit from the base messenger class similar to the MockMessengerService

class MockMessengerService(BaseMessengerService):
    """A fallback implementation of the Messenger Service."""
    def generate_opener(self, profile: MatchProfile) -> MessageResponse:
        """Generate a default opening message."""
        return MessageResponse(message=f"Hi {profile.name} 😊!")

    def generate_reply(
        self,
        profile: MatchProfile,
        last_messages: Optional[List[Message]] = None
    ) -> MessageResponse:
        """Generate an empty reply."""
        raise NotImplementedError("Reply is not implemented")

---

⚠️ Disclamer

Automation is against Tinder's TOS.

This project is for educational purposes only. You are responsible for any consequences, including account bans or legal actions.

---