project-tgbot-assistant
🗓️ Calendar Assistant Bot
Умный Telegram-бот для управления событиями календаря с функцией геолокации и автоматическими напоминаниями. Бот анализирует ваше местоположение и предупреждает, если вы можете опоздать на встречу.
🌟 Особенности
- 📅 Синхронизация с Google Calendar
- 📍 Определение местоположения через Telegram или по адресу события
- ⏱ Автоматические уведомления о предстоящих событиях
- 🚦 Проверка возможности успеть на встречу по текущему местоположению
- 📌 Категоризация событий (работа, учёба, спорт, отдых)
- 🔄 Возможность переноса встречи с уведомлением участников
- 📱 Удобный интерфейс с кнопками и инлайн-меню
🛠 Технологии
- Python 3.8+
- python-telegram-bot
- Google Calendar API
- Yandex Maps API (геокодирование)
- SQLite (хранение данных)
- dotenv (управление конфигурацией)
⚙️ Установка
- Клонируйте репозиторий:
Установите зависимости:
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 для получения дополнительной информации.