project-tgbot-assistant

0
README.md

🗓️ Calendar Assistant Bot

Python Telegram Google Calendar License

Умный Telegram-бот для управления событиями календаря с функцией геолокации и автоматическими напоминаниями. Бот анализирует ваше местоположение и предупреждает, если вы можете опоздать на встречу.

🌟 Особенности

  • 📅 Синхронизация с Google Calendar
  • 📍 Определение местоположения через Telegram или по адресу события
  • ⏱ Автоматические уведомления о предстоящих событиях
  • 🚦 Проверка возможности успеть на встречу по текущему местоположению
  • 📌 Категоризация событий (работа, учёба, спорт, отдых)
  • 🔄 Возможность переноса встречи с уведомлением участников
  • 📱 Удобный интерфейс с кнопками и инлайн-меню

🛠 Технологии

  • Python 3.8+
  • python-telegram-bot
  • Google Calendar API
  • Yandex Maps API (геокодирование)
  • SQLite (хранение данных)
  • dotenv (управление конфигурацией)

⚙️ Установка

  1. Клонируйте репозиторий:

Установите зависимости:

bash pip install -r requirements.txt Создайте файл .env и заполните его:

ini TELEGRAM_BOT_TOKEN=ваш_токен_бота GOOGLE_CREDENTIALS_FILE=credentials.json GOOGLE_CALENDAR_ID=ваш_id_календаря OWNER_IDS=ваш_telegram_id YANDEX_MAPS_API_KEY=ваш_ключ_яндекс_карт Поместите файл учетных данных Google в папку проекта

🚀 Запуск bash python bot.py 📷 Скриншоты Главное меню Уведомление Геолокация Меню Уведомление Геолокация 📌 Команды /start - Начало работы с ботом

"События на сегодня" - Показать список событий

"Спроси меня, что я умею" - Информация о возможностях бота

🌍 Пример работы Бот проверяет календарь каждые 30 минут

За 15 минут до события проверяет ваше местоположение

Если вы далеко от места встречи:

Предлагает перенести встречу

По запросу уведомляет участников

Если вы рядом - хвалит вас!

📄 Лицензия Этот проект распространяется под лицензией MIT. См. файл LICENSE для получения дополнительной информации.