Skip to content

OPHoperHPO/vk-bot-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🥐 vk-bot-template 🥐

📄 Описание

Универсальный python бот-заготовка для https://vk.com/. \

🏷 Версия

Текущая версия: [Common Update][1.2].

🎆 Возможности бота:

  • Это longpoll бот.
  • Бот умеет отвечать как в беседах, так и в личных сообщениях для отдельных пользователей.
  • В боте реализована поддержка threading.
  • Добавлена система авторизации по id пользователя с подразделениями на 4 уровня допуска к функциям.
  • Присутствует возможность добавлять команды на русском языке. Например: Поищи Апельсин
  • Текст сообщений для бота разнесён на отдельные файлы, что делает их редактирование крайне простым.
  • Написано несколько example функций. Поиск в DuckDuckGo, отправка сообщения пользователя от имени группы, отправка help сообщения.
  • Добавление функций для бота является очень простой задачей. (см. Wiki)
  • Конфигурация бота содержится в одном json файле с подразделениями на разделы.
  • При потере интернет соединения, бот терпиливо ждёт восстановления соединения, посылая раз в две минуты GET запрос к vk.com.

🧷 Зависимости:

vk_api - Необходимо для функционирования бота
requests - Необходимо для исключения краша бота в случае отсутствия интернет соединения и функции (Поиск в DuckDuckGo)
json - Необходимо для парсинга config.json и text_id.json

🏷 Запуск бота:

  • ВНИМАНИЕ! Бота нужно запускать из PROJECT ROOT(это папка, где он лежит)!
  • Скачиваем репозиторий в какую-нибудь папку. git clone https://github.com/OPHoperHPO/python_vk_bot
  • Идём по пути cd config
  • Прописываем в config.json бота longpoll токен, id группы. Также необходимо вписать id админа в bot_creator для доступа ко всем функциям бота.
  • Возвращаемся в корневую директорию. cd ..
  • Запускаем бота. python3 bot.py

⏳ TODO:

1) Написать example модуль. (25% done).
2) Написать грамотное wiki для бота. (25% done).

💵 Поддержка проекта:

Вы можете поблагодарить меня за разработку этого проекта, оказать финансовую поддержку для разработки новых проектов и купить мне маленькую чашку кофе ☕.
Просто поддержите меня на этих платформах: