| Name | tinder-ai JSON |
| Version |
0.1.6
JSON |
| download |
| home_page | None |
| Summary | A Tinder bot SDK using Selenium and AI |
| upload_time | 2025-02-16 21:13:26 |
| maintainer | None |
| docs_url | None |
| author | timfdev |
| requires_python | <4.0,>=3.10 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<img src="static/tinder.svg" align="center" width="30%">
</p>
<p align="center"><h1 align="center">TINDER-AI</h1></p>
<p align="center">
<em><code>❯ Build an AI dating bot</code></em>
</p>
<p align="center">
<!-- local repository, no metadata badges. --></p>
<p align="center">
<img src="https://img.shields.io/badge/Selenium-43B02A.svg?style=default&logo=Selenium&logoColor=white" alt="Selenium">
<img src="https://img.shields.io/badge/-OpenAI%20API-eee?style=flat-square&logo=openai&logoColor=412991" alt="OpenAI">
<br>
<img src="https://img.shields.io/badge/Python-3776AB.svg?style=default&logo=Python&logoColor=white" alt="Python">
<img src="https://img.shields.io/badge/Poetry-60A5FA.svg?style=default&logo=Poetry&logoColor=white" alt="Poetry">
<img src="https://img.shields.io/badge/Pydantic-E92063.svg?style=default&logo=Pydantic&logoColor=white" alt="Pydantic">
</p>
<br>
## 📌 Table of Contents
- [Overview](#-overview)
- [Setup](#-setup)
- [Usage](#-usage)
- [Session](#-session)
- [Openers](#-openers)
- [Replies](#-replies)
- [Auto-Swiping](#-auto-swiping)
- [Messenger Service](#-messenger-service)
- [Disclaimer](#-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**
```shell
pip install tinder-ai
```
**Copy the `.env.example` file to `.env`:**
```sh
cp .env.example .env
```
Edit .env and fill in the required values.
---
## 🛠 Usage
#### Session: Set up a session
```python
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
```python
session.handle_matches()
```
#### Replies: Auto-reply unread messages
```python
session.handle_unread_messages()
```
#### Auto-Swiping: Swipe on profiles automatically
```python
session.start_swiping()
```
### Messenger Service
##### Option 1: Using an API
Plug in your own LLM service to use for messaging.
```python
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`
```python
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.
---
Raw data
{
"_id": null,
"home_page": null,
"name": "tinder-ai",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "timfdev",
"author_email": "frohcode@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b5/62/2db7d574c36298174cd6525685691d71112c1aaeee1c629b7f79fc364156/tinder_ai-0.1.6.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"static/tinder.svg\" align=\"center\" width=\"30%\">\n</p>\n<p align=\"center\"><h1 align=\"center\">TINDER-AI</h1></p>\n<p align=\"center\">\n\t<em><code>\u276f Build an AI dating bot</code></em>\n</p>\n<p align=\"center\">\n\t<!-- local repository, no metadata badges. --></p>\n<p align=\"center\">\n\t<img src=\"https://img.shields.io/badge/Selenium-43B02A.svg?style=default&logo=Selenium&logoColor=white\" alt=\"Selenium\">\n\t<img src=\"https://img.shields.io/badge/-OpenAI%20API-eee?style=flat-square&logo=openai&logoColor=412991\" alt=\"OpenAI\">\n\t<br>\n\t<img src=\"https://img.shields.io/badge/Python-3776AB.svg?style=default&logo=Python&logoColor=white\" alt=\"Python\">\n\t<img src=\"https://img.shields.io/badge/Poetry-60A5FA.svg?style=default&logo=Poetry&logoColor=white\" alt=\"Poetry\">\n\t<img src=\"https://img.shields.io/badge/Pydantic-E92063.svg?style=default&logo=Pydantic&logoColor=white\" alt=\"Pydantic\">\n</p>\n<br>\n\n## \ud83d\udccc Table of Contents\n- [Overview](#-overview)\n- [Setup](#-setup)\n- [Usage](#-usage)\n - [Session](#-session)\n - [Openers](#-openers)\n - [Replies](#-replies)\n - [Auto-Swiping](#-auto-swiping)\n- [Messenger Service](#-messenger-service)\n- [Disclaimer](#-disclaimer)\n\n---\n\n## \ud83d\ude80 Overview\nTinder-AI is a **Tinder bot SDK** using **Selenium with undetected Chromedriver**. It provides:\n- **Profile setup**\n- **Proxy support**\n- **Geolocation spoofing**\n- **Automated swiping**\n- **Chatbot integration (Openers & replies)**\n\nUse it to build your own **AI dating assistant**.\n\n---\n\n## \u2699\ufe0f Setup\n\n**Install the package**\n```shell\npip install tinder-ai\n```\n\n**Copy the `.env.example` file to `.env`:**\n```sh\ncp .env.example .env\n```\n\nEdit .env and fill in the required values.\n\n---\n\n## \ud83d\udee0 Usage\n#### Session: Set up a session\n```python\nfrom tinder_ai import Settings, Session\n\nsettings = Settings()\nmessenger_service = MockMessengerService()\nwith Session(\n\tsettings=settings,\n\tmessenger_service=messenger_service\n) as session:\n\tsession.login(\n\t\tmethod=settings.get_login_method()\n\t)\n```\n\n#### Openers: Send a first message to all matches\n```python\nsession.handle_matches()\n```\n\n#### Replies: Auto-reply unread messages\n```python\nsession.handle_unread_messages()\n```\n\n#### Auto-Swiping: Swipe on profiles automatically\n```python\nsession.start_swiping()\n```\n\n### Messenger Service\n\n##### Option 1: Using an API\nPlug in your own LLM service to use for messaging.\n```python\nmessenger_service = MessengerService(\n\tbase_url=\"http://0.0.0.0:8080\"\n)\nsession = Session(\n\tsettings=settings,\n\tmessenger_service=messenger_service\n)\n```\n\n##### Option 2: Using a custom class\nInherit from the base messenger class similar to the `MockMessengerService`\n```python\nclass MockMessengerService(BaseMessengerService):\n \"\"\"A fallback implementation of the Messenger Service.\"\"\"\n def generate_opener(self, profile: MatchProfile) -> MessageResponse:\n \"\"\"Generate a default opening message.\"\"\"\n return MessageResponse(message=f\"Hi {profile.name} \ud83d\ude0a!\")\n\n def generate_reply(\n self,\n profile: MatchProfile,\n last_messages: Optional[List[Message]] = None\n ) -> MessageResponse:\n \"\"\"Generate an empty reply.\"\"\"\n raise NotImplementedError(\"Reply is not implemented\")\n\n```\n\n---\n## \u26a0\ufe0f Disclamer\n\n**Automation is against Tinder's TOS.**\n\nThis project is for **educational purposes only**.\nYou are responsible for any consequences, including account bans or legal actions.\n\n---",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Tinder bot SDK using Selenium and AI",
"version": "0.1.6",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "103d627bc7222216b70d44c203dd9048ad8c3dc794e3111a7110adf3c48726a0",
"md5": "27563f7b1382abaf93ca0c7b088863c1",
"sha256": "bff74442dec890e6c8c4f63f44f62d7d2f97782a42983f5775a7b40d8071a7e8"
},
"downloads": -1,
"filename": "tinder_ai-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "27563f7b1382abaf93ca0c7b088863c1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 27487,
"upload_time": "2025-02-16T21:13:25",
"upload_time_iso_8601": "2025-02-16T21:13:25.872875Z",
"url": "https://files.pythonhosted.org/packages/10/3d/627bc7222216b70d44c203dd9048ad8c3dc794e3111a7110adf3c48726a0/tinder_ai-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b5622db7d574c36298174cd6525685691d71112c1aaeee1c629b7f79fc364156",
"md5": "e55534fdd1b6921d32ebe21fa285b51e",
"sha256": "20377ade76fbc7b71affbc26eb2dc6bd698f1af8d6386ebe701cea4cb661e5c9"
},
"downloads": -1,
"filename": "tinder_ai-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "e55534fdd1b6921d32ebe21fa285b51e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 22467,
"upload_time": "2025-02-16T21:13:26",
"upload_time_iso_8601": "2025-02-16T21:13:26.895032Z",
"url": "https://files.pythonhosted.org/packages/b5/62/2db7d574c36298174cd6525685691d71112c1aaeee1c629b7f79fc364156/tinder_ai-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-16 21:13:26",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tinder-ai"
}
