bot-maxapi

A hackathon bot from the Max messenger in Python using the maxapi library. Hackathon team 82. https://max.ru/t82_hakaton_bot

Запуск

Быстрый старт локально (Windows/Linux/MacOS)

1. Склонируйте репозиторий, перейди в папку с проектом

Внутри должны лежать:

• main.py
• requirements.txt
• Dockerfile
• все вспомогательные .py
• база (например, basic_base.db)
• и другие необходимые файлы.

2. Проверь файл requirements.txt

Файл должен содержать только сторонние библиотеки:

maxapi
aiohttp
matplotlib     
pandas
dotenv        

3. Сборка Docker-образа

Команда для сборки:

• -t max-bot
  — имя образа
• .
  — использовать текущую директорию как контекст сборки

4. Запуск контейнера

Если бот требует токен Max (или другой секрет), передавай его через переменную окружения:

• --rm
  — контейнер автоматически удаляется после остановки
• -e
  — передача переменных окружения
• max-bot
  — имя образа

5. Пример запуска из командной строки (Windows)

Открой PowerShell или CMD в папке с проектом и выполни:

6. Остановка контейнера

• Нажми
  Ctrl + C
  — контейнер завершит работу.
• Либо в отдельном терминале введи (если запуск без
  --rm
  ):

7. Обновление зависимостей

Если добавил новые зависимости — отредактируй файл requirements.txt и пересобери образ через

Запуск без Docker (альтернатива)

Если хочешь запустить проект локально без контейнера:

Технические требования

• Docker 20+ (Desktop или CLI)
• Python 3.13 (для локального запуска)
• Max API токен (для работы бота)

О самом боте

Бот создавался в рамках хакатона от MAX и VK Education. Трек «Эффективность»: разработка сервисов продуктивности. Хакатон 82: https://max.ru/t82_hakaton_bot Бот представляет из себя планировщика задач и заметчика. Позваляет писать планы и заметки, хронит всю информацию, напоминает планы и какие-то заметки.

Основные команды:

• /start - начало и главная страница
• /help - помощь, руководство по использованию
• /info - о самом боте
• /delete - удалить данные о себе
• /create_day - создать список на день
• /create_plan - создать список по дням
• /view_plan - посмотреть список
• /edit_plan - отредактировать список дел
• /view_static - посмотреть статистику
• /note - управлять заметками