Telegram Bot Development - Python

Title (if required by the platform):

Telegram Bot "Find People Nearby for a Walk" (Python)

Task Description:

Hello! I need a simple Telegram bot in Python with the following features:

Main Functionality:

User Registration:

The user launches the bot (/start).

The bot saves the Telegram ID, username, and name.

Sending Location:

The user sends their current location via Telegram.

The location is saved in the database (Postgres or SQLite).

Ready to Walk / Not Ready to Walk Status:

The /go command — mark yourself as ready for a walk.

The /stop command — disables the status.

The status duration is stored in the database (e.g., 2 hours).

Searching for Nearby Users:

The /who command — displays a list of people near the user (e.g., within a 2 km radius).

The list is sorted by distance.

You can limit the display to the first 20 people.

Invite to a walk:

There's an "Invite" button next to the list.

After clicking, the bot asks you to write a short invitation message.

The message is sent to the selected user with "Accept/Decline" buttons.

When accepted or declined, the bot notifies the sender.

The sender's location is obfuscated (not the exact coordinates, slightly offset for privacy).

Technical requirements:

Language: Python 3.11+

Telegram API via the pyTelegramBotAPI library or aiogram

Data storage: Postgres (or SQLite, if simpler)

Minimal front-end, everything via Telegram

The code should be clean, easy to read, and commented.

Additional (optional, but not required):

Automatically remove the "ready to walk" status after 2 hours.

Minimal spam protection (one invite per minute).

What I want to get:

A working bot that can be run on a local computer or server.

Full source code with launch instructions.

A simple database (possibly with migrations).

Budget:

Preferably small, approximately $50 for a working prototype.