{"id":25746164,"url":"https://github.com/bohd4nx/gifts-buyer","last_synced_at":"2025-06-26T08:35:51.219Z","repository":{"id":262109262,"uuid":"886241280","full_name":"bohd4nx/Gifts-Buyer","owner":"bohd4nx","description":"Automated Telegram userbot for purchasing gifts with smart prioritization, multiple recipients, and intelligent balance management.","archived":false,"fork":false,"pushed_at":"2025-06-23T14:46:37.000Z","size":304,"stargazers_count":156,"open_issues_count":3,"forks_count":46,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-06-23T15:44:33.894Z","etag":null,"topics":["auto-sender","gifts","telegram","user-bot"],"latest_commit_sha":null,"homepage":"https://t.me/GiftsTracker","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/bohd4nx.png","metadata":{"files":{"readme":"README-RU.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,"zenodo":null}},"created_at":"2024-11-10T15:10:20.000Z","updated_at":"2025-06-23T14:46:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"8e39f998-f37b-4a14-98c7-f610b90667f5","html_url":"https://github.com/bohd4nx/Gifts-Buyer","commit_stats":null,"previous_names":["bohd4nx/tggifts-buyer","bohd4nx/gifts-buyer"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/bohd4nx/Gifts-Buyer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bohd4nx%2FGifts-Buyer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bohd4nx%2FGifts-Buyer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bohd4nx%2FGifts-Buyer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bohd4nx%2FGifts-Buyer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bohd4nx","download_url":"https://codeload.github.com/bohd4nx/Gifts-Buyer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bohd4nx%2FGifts-Buyer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262030765,"owners_count":23247714,"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":["auto-sender","gifts","telegram","user-bot"],"created_at":"2025-02-26T11:30:03.471Z","updated_at":"2025-06-26T08:35:51.206Z","avatar_url":"https://github.com/bohd4nx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram Gifts Buyer\n\n\u003cimg src=\"https://github.com/user-attachments/assets/40f64ac9-ff84-4b31-85fd-b6ab01116bdb\" alt=\"Program Preview\" width=\"100%\" /\u003e\n\nАвтоматический Telegram бот для покупки подарков с умной приоритизацией, поддержкой нескольких получателей и контролем\nбаланса.\n\n\u003e 🌐 [English version](README.md)\n\n## ✨ Возможности\n\n- **🤖 Автоматический мониторинг**: Постоянно сканирует новые подарки по вашим критериям\n- **🎯 Умная приоритизация**: Приоритет редким подаркам (малый тираж) в ваших ценовых диапазонах\n- **👥 Несколько получателей**: Разное количество для разных пользователей/каналов в каждом диапазоне\n- **💰 Контроль баланса**: Частичные покупки при нехватке средств\n- **📊 Подробные уведомления**: Подтверждения покупок, оповещения о балансе и сводки\n- **🔧 Гибкая настройка**: Простой формат для ценовых диапазонов и получателей\n- **🌍 Два языка**: Русский и английский интерфейс\n\n## 🚀 Установка\n\n```bash\ngit clone https://github.com/bohd4nx/Gifts-Buyer.git\ncd Gifts-Buyer\npip install -r requirements.txt\n```\n\nНастройте `config.ini` и запустите:\n\n```bash\npython main.py\n```\n\n## 🐳 Запуск через Docker\n\nВы можете запустить бота через Docker. Для этого необходимо пройти однократную авторизацию Telegram и после запустить в\nфоне.\n\n### 1. Сборка образа\n\n```bash\ndocker compose build\n```\n\n### 2. Авторизация в Telegram (однократная настройка)\n\n```bash\ndocker compose run --rm gift-buyer\n```\n\nСледуйте инструкциям для входа в Telegram. Сессия будет сохранена в папке `./data/`.\n\n\u003e ℹ️ Эту команду нужно выполнять только один раз — до тех пор, пока сессия активна.\n\n### 3. Запуск бота в фоне\n\n```bash\ndocker compose up -d\n```\n\nБот использует сохранённую сессию и настройки из `config.ini`.\n\n### 4. Остановка бота (при необходимости)\n\n```bash\ndocker compose down\n```\n\n## ⚙️ Настройка\n\n### Основные настройки\n\n```ini\n[Telegram]\nAPI_ID = ваш_api_id                   # С https://my.telegram.org/apps\nAPI_HASH = ваш_api_hash               # С https://my.telegram.org/apps\nPHONE_NUMBER = +1234567890            # Ваш номер телефона\nCHANNEL_ID = -100xxxxxxxxx            # Канал для уведомлений (-100 чтобы отключить)\n\n[Bot]\nINTERVAL = 10                         # Интервал проверки в секундах\nLANGUAGE = RU                         # Язык интерфейса (EN/RU)\n\n[Gifts]\n# Формат: ценовой_диапазон: лимит_тиража x количество: получатели\nGIFT_RANGES = 1-1000: 500000 x 1: @user1, 123456; 1001-5000: 100000 x 2: @канал\n\nPURCHASE_ONLY_UPGRADABLE_GIFTS = False # Покупать только улучшаемые подарки\nPRIORITIZE_LOW_SUPPLY = True           # Приоритет редким подаркам\n```\n\n### Формат диапазонов подарков\n\n**Формат**: несколько диапазонов, разделённых `;`  \nКаждый диапазон: `мин_цена-макс_цена: лимит_тиража x количество: получатели`\n\n**Примеры**:\n\n- `1-1000: 500000 x 1: @johndoe, 123456789` - Дешёвые подарки, по 1 копии\n- `1001-5000: 100000 x 2: @канал, @пользователь` - Средний диапазон, по 2 копии\n- `5001-50000: 50000 x 5: 987654321` - Дорогие подарки, 5 копий\n\n**В результате**:  \n`GIFT_RANGES = 1-1000: 500000 x 1: @johndoe, 123456789; 1001-5000: 100000 x 2: @канал, @user; 5001-50000: 50000 x 5: 987654321`\n\n**Получатели могут быть**:\n\n- Юзернеймы: `@username`\n- ID пользователей: `123456789`\n- Названия каналов: `@channelname`\n\n### Как работает\n\n1. **Мониторинг**: Бот каждые `INTERVAL` секунд проверяет новые подарки\n2. **Фильтрация**: Обрабатывает только подарки из ваших диапазонов цен и тиража\n3. **Приоритизация**: Если `PRIORITIZE_LOW_SUPPLY = True`, сначала редкие подарки\n4. **Покупка**: Покупает указанное количество для каждого получателя в диапазоне\n5. **Проверка баланса**: Частичные покупки при нехватке средств\n\n## 💰 Контроль баланса\n\nБот рассчитывает сколько подарков может купить перед покупкой:\n\n```\nПример:\n- Подарок стоит 1500⭐, хотим купить 4 штуки\n- Текущий баланс: 4500⭐\n- Результат: Покупает 3 штуки, сообщает что не хватает 1500⭐ для последнего\n```\n\n## 📝 Советы\n\n- Держите баланс в 2-3 раза больше самого дорогого диапазона\n- Используйте несколько диапазонов для разных стратегий\n- Включите уведомления для контроля активности\n- Сначала протестируйте на малых диапазонах\n- Запускайте на VPS для работы 24/7\n\n---\n\n\u003cdiv align=\"center\"\u003e\n    \u003ch4\u003e🚀 Built with ❤️ by \u003ca href=\"https://t.me/bohd4nx\"\u003eBohdan\u003c/a\u003e • \u003ca href=\"https://app.tonkeeper.com/transfer/UQBUAa7KCx1ifmoEy6lF7j-822Dm_cE1j9SR7UWteu3jzukV?amount=0\u0026text=Thanks%20for%20Gifts-Buyer\"\u003eDonate\u003c/a\u003e\u003c/h4\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbohd4nx%2Fgifts-buyer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbohd4nx%2Fgifts-buyer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbohd4nx%2Fgifts-buyer/lists"}