Что такое userbot Hikka и с чем его едят
🌘 Hikka
Краткое описание
Основная цель Hikka - обеспечить удобство разработчикам путем добавления встроенных методов для всего и вся, чтобы не надо было писать одно и то же вручную.
Первое что я хочу вам показать, это комманды:
Основное использование
.help - Отображение всех доступных команд.
.help <команда / модуль> - Получение справки по конкретной команде.
.cfg - Настройка модулей.
.heta <запрос> - Поиск модуля. Запросом может быть команда, название модуля или описание.
.dlm <ссылка / название> - Загрузить модуль из хранилища или по внешней ссылке.
.lm <ответить на файл> - Загрузить модуль из файла.
.ulm <модуль> - Выгрузить модуль.
.ping - Проверить, активен ли бот.
.restart - Перезапустить бота.
.update - Обновить бота.
.logs - Получить логи бота.
.terminal <команда> - Выполнить команду bash.
.e <выражение> - Вычислить выражение Python.
.support - Получить ссылку на официальную группу поддержки.
..sec <"пользователь" / "чат"> <цель> <команда / модуль> [время] - Настроить безопасность.
Модули, что же это?
Если сказать кратко, то это коробка инструментов, которая покупается(устанавливается), берется инструмент(ввод комманды) и этим инструментом пользуются(производится задача)
Например есть такой модуль как Love, по комманде он изменяет это же самое сообщение на милые слова
Каналы где брать модули:
@HikkaUsers @hikarimods @morisummermods @cakestwix_mods @nalinormods @astromodules @vsecoder_m @mm_mods @apodiktum_modules @wilsonmods @amoremods @shadow_modules @DorotoroMods @hikka_mods
1. Решите где будет установлен юзербот:
Для юзербота нужна машина(желательно удаленная, или по другому ВДС), вот часто используемые примеры:
А. Советую новичкам использовать в начале Okteto, ибо бесплатно(чтобы решить нужно ли вам больше), некоторые функции будут не доступны, но установка проста, и будет описана в следующем этапе.
Б. Используйте @hikkahost, самый дешёвый тариф, который подойдёт для одного юзербота стоит 93₽, но установка проходит без вашего вмешательства быстро и сама!
Г. Купите вдс, очень геморрное решение, обычно цены начинаются от 100₽ и придётся махаться с установкой.
Д. Купить одноплатник(упоминать дальше не буду, можете написать в ЛС @vsecoder помогу), цены начинаются от 2к₽, но при этом навсегда, у вас под рукой и много других плюшек.
Ж. Поставить на своем ПК, думаю от этого есть смысл только если комп работает 24/7 и на системе Линукс, так что идея плохая, а установка такая же как и с вдс.
2. Установка
Решив куда будете ставить в итоге юзербота, начнём рассматривать установку:
А. На октето всё легко, регистрируетесь на okteto.com, а дальше переходим по ссылке: https://cloud.okteto.com/#/deploy?repository=https://github.com/hikariatama/Hikka и следуете инструкции из скринов:
Тут надо будет подождать, пока справа вверху под характеристиками не изменится надпись с Processing на Running
Найдите строку "Endpoint: ..." и перейдите по ссылке, в "3." будет инструкция по подключению аккаунта.
Б. В @lavhostbot всё проходит автоматически, так что можете пропустить установку.
В. Для начала нам надо зарегистрировать, при регистрации под Российским IP может вылезти ошибка, так что впн/прокси в помощь.
стоит не забыть при регистрации указать другую страну
После регистрации переходим по ссылке https://dashboard.heroku.com/account, где нам надо будет скопировать API token(key):
А дальше самое интересное, deploy хикки, переходим и заполняем как на скрине с правками(app name - свой, но должен начинаться с "hikka-"(если поле красное, значит имя занято), свой токен, который получили раньше, и выбираем Europe(иначе пинг будет +100500)):
Хах, ждать, и оказалось ждать долго...
В итоге получаем что всё удачно, и нажимаем на View переходя к этапу 3!
Г. Настройка на ВДС полна сюрпризов, так что запаситесь терпением, и поймите что мне это было писать сложнее, чем вам устанавливать)))
Советую брать VDS от https://firstvds.ru/products/vds_vps_hosting
Установка на VDS обычно может чуть отличаться, так что заходите в чат https://t.me/hikka_talks, там вам помогут если что-то пошло не так
Начнём с того, что все вам в итоге после покупки отправят на панель с кучей хлама, там вам надо найти SSH, и подключиться(https://firstvds.ru/technology/how-to-connect-to-the-server-via-ssh), в итоге после подключение проверьте наличие и версию python командой:
python3 -V
Если там меньше 3.8 или ошибка(нет python), то советую почитать про установку и обновление(https://www.digitalocean.com/community/tutorials/how-to-install-python-3-and-set-up-a-programming-environment-on-an-ubuntu-18-04-server-ru)
Но обычно всё есть, и последней версии, так что перейдём к установке, разработчик постарался над установщиком, так что вводим:
. <(wget -qO- http://gg.gg/get_hikka)
Хотя это не всегда срабатывает, и мы не видем этапы установки, так что предпочитаю сделать в ручную(вводите команды):
git clone https://github.com/hikariatama/Hikka
cd Hikka
pip install -r requirements.txt
python3 -m hikka
Обычно это может занимать время от 2х минут, поэтому советую читать ошибки и предупреждения, обычно в них сразу написана причина ошибки.
и в итоге мы получаем ссылку, по которой переходите, и читайте "3."
3. Подключение аккаунта(возможно скоро сделаю со скринами, просто нет аккаунта нового)
Финальный этап, и обычно очень лёгкий!
А. В "2.А" мы закончили перейдя по ссылке, вкладку с ней мы не трогаем, и идём на https://my.telegram.org/auth, где благополучно входим в аккаунт и переходим на https://my.telegram.org/apps, тут мы обращаем внимание на "App configuration", и поля в нём, а точнее "App api_id:" и "App api_hash:".
Их возможно не будет, и вам придётся создать новый app, это затрагивать не буду, потому что там надо лишь заполнять поля.
Ну и на сайте нажимаем кнопку "Get started", заполняя поля данными, которые запросит, обычно это номер, и данные app, ну id и hash, а также поле про ник бота, советую ничего там не писать, позже можно будет изменить!
Б. Лавхост имеет хорошуу инструкцию, так что просто выполняйте по этапам то, что просит бот.
Г. Всё тоже самое что и в "3.А", ведь последний этап установки на сервер через сайт в итоге идентичен.
Если вам начали приходить сообщения от бота, то значит установка завершена!