{"id":21747510,"url":"https://github.com/zaitsev-dev/telehotels","last_synced_at":"2026-05-19T02:47:59.019Z","repository":{"id":249353222,"uuid":"423679616","full_name":"zaitsev-dev/telehotels","owner":"zaitsev-dev","description":"Telegram-bot to search hotels using the external API","archived":false,"fork":false,"pushed_at":"2021-11-12T16:25:48.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-25T22:54:41.941Z","etag":null,"topics":["python","rapidapi","telegram","telegram-bot","telegrambotapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zaitsev-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-02T02:16:57.000Z","updated_at":"2022-12-10T18:08:49.000Z","dependencies_parsed_at":"2024-07-20T07:20:44.042Z","dependency_job_id":null,"html_url":"https://github.com/zaitsev-dev/telehotels","commit_stats":null,"previous_names":["zaitsev-dev/telehotels"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Ftelehotels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Ftelehotels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Ftelehotels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaitsev-dev%2Ftelehotels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zaitsev-dev","download_url":"https://codeload.github.com/zaitsev-dev/telehotels/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244722734,"owners_count":20499154,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","rapidapi","telegram","telegram-bot","telegrambotapi"],"created_at":"2024-11-26T08:09:20.758Z","updated_at":"2026-05-19T02:47:53.989Z","avatar_url":"https://github.com/zaitsev-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cp align=\"center\"\u003eTeleHotels Bot\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Реализация Telegram-бота для поиска отелей, использующий API\n  сервиса \u003ca href=\"https://hotels.com/\"\u003eHotels.com\u003c/a\u003e \u003cbr\u003e\n  Implementation of Telegram-bot for hotel search using\n  \u003ca href=\"https://hotels.com/\"\u003eHotels.com\u003c/a\u003e API\n\u003c/p\u003e\n\n\u003cp align=\"right\"\u003e\n\u003ci\u003eПроект был создан в образовательных целях.\u003c/i\u003e \u003cbr\u003e\n\u003ci\u003eThe project was created for educational purposes.\u003c/i\u003e\n\u003c/p\u003e\n\n---\n## Содержание / Contents\n\n**На русском:**\n1. [Установка и запуск](#Установка-и-запуск)\n2. [Запуск с Webhook и Ngrok](#Запуск-с-Webhook-и-Ngrok)\n\n**In English:**\n1. [Installing and launch](#Installing-and-launch)\n2. [Using Webhook through Ngrok](#Using-Webhook-through-Ngrok)\n\n---\n\n## Установка и запуск\n\n- Клонируйте репозиторий:\n```shell\ngit clone https://github.com/Leetovskiy/telehotels.git\n```\n\n- Установите зависимости из файла `Pipfile.lock` с помощью `pipenv`\n([инструкции по установке pipenv](https://github.com/pypa/pipenv#installation)):\n```shell\npipenv install\n```\n\n- Переименуйте файл `.env.example` в `.env` и задайте в нем следующие переменные:\n  - `TG_BOT_TOKEN` – токен Telegram-бота;\n  - `RAPID_API_KEY` – ключ для доступа к [Rapid API](https://rapidapi.com/);\n  - `DATABASE_PATH` (необ.) – относительный путь к файлу базы данных SQLite\n  (по умолчанию равен текущей директории).\n\n- Запустите файл `main.py` из виртуального окружения Pipenv:\n```shell\npipenv run python main.py\n```\n\n\n## Запуск с Webhook и Ngrok\n\nПо умолчанию бот использует polling-метод для получения обновлений с серверов \nTelegram. Так как polling создаёт лишнюю нагрузку на сеть, рекомендуется \nиспользовать Webhook. Ниже приведена инструкция для запуска бота в режиме\nWebhook на локальном устройстве с помощью [Ngrok](https://ngrok.com/).\n\n- Запустите Ngrok-туннель на порт 8443:\n```shell\n./ngrok http 8443\n```\n\n- Скопируйте имя хоста (без `https://`) из строки \"Forwarding\" и\nпоместите его в переменную `WEBHOOK_HOST` файла `.env`\n\n- Запустите бота с параметром `--webhook`:\n```shell\npipenv run python main.py --webhook\n```\n\n---\n\n## Installing and launch\n\n- Clone repository anywhere you want:\n```shell\ngit clone https://github.com/Leetovskiy/telehotels.git\n```\n\n- Install requirements from `Pipfile.lock` via `pipenv`\n([Pipenv installation instruction](https://github.com/pypa/pipenv#installation))\n```shell\npipenv install\n```\n\n- Rename `.env.example` to `.env` and specify these variables:\n  - `TG_BOT_TOKEN` – Telegram-bot token;\n  - `RAPID_API_KEY` – [Rapid API](https://rapidapi.com/) access key;\n  - `DATABASE_PATH` (optional) – relative path to SQLite database.\n\n- Run `main.py` via Pipenv virtual environment:\n```shell\npipenv run python main.py\n```\n\n\n## Using Webhook through Ngrok\n\nBy default, the bot uses the polling method to get updates from the  Telegram\nservers. Since polling creates unnecessary load on the network, it is\nrecommended to use Webhook. Here are the instructions for running the bot in\nWebhook mode on your local device using [Ngrok](https://ngrok.com/).\n\n- Run Ngrok and set up tunnel to 8443 port:\n```shell\n./ngrok http 8443\n```\n\n- Copy the hostname (exclude `https://` part) from \"Forwarding\" row and put this \nto `WEBHOOK_HOST` variable in the `.env` file\n\n- Run the bot with the `webhook` parameter:\n```shell\npipenv run python main.py --webhook\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaitsev-dev%2Ftelehotels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaitsev-dev%2Ftelehotels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaitsev-dev%2Ftelehotels/lists"}