Чтобы запустить бота hikari 24/7, держите его на машине, которая всегда включена, а не на своём ПК: на Linux VPS с сервисом systemd, если вы хостите сами, или на тарифе для ботов в хостинге Discord-ботов PlayNHost (от US$1.99 в месяц), где вы загружаете код, вставляете токен и нажимаете Start. В нашем тесте бот на hikari 2.7.0 занял около 61 МБ памяти и дошёл до Discord примерно через 1,3 секунды после запуска. hikari 2.7 требует Python 3.11 или новее и не имеет собственного фреймворка команд, поэтому на этой странице есть slash-команда, написанная только на hikari. Шаги в PlayNHost:
- На странице Хостинг Discord-ботов нажмите Создать сервер на нужном тарифе. В окне заказа ответьте на Для какой платформы ваш бот? выбором Discord и выберите Python.
- Откройте свой сервер в панели. Карточка Настройка бота на странице Обзор открывается на шаге Подключение к Discord. Её первый шаг, Что запускается, должен показывать Этот бот запускает Python Bot.; нажмите на этот шаг, чтобы проверить, затем Продолжить.
- На шаге Подключение к Discord вставьте токен в поле Вставьте токен бота, нажмите Подключение, затем Да, продолжить.
- На шаге Разрешения отметьте Мой код это использует только для привилегированных интентов, которые запрашивает ваш код (бот ниже не нуждается ни в одном), нажмите Добавить на сервер Discord, затем Продолжить.
- На шаге Ваш код нажмите Загрузить файлы и загрузите
bot.pyиrequirements.txtсо строкойhikariлибо нажмите Подключить Git. - На странице Бот, в блоке Код, оставьте Среда выполнения на Python 3.12 (recommended) или выберите 3.11, 3.13 или 3.14 (не 3.10), укажите Файл запуска, если это не
bot.py, и нажмите Сохранить. - Нажмите Запустить бота и следите за Console. Когда бот выведет
Logged in as ..., карточка покажет Ваш бот онлайн в Discord.
Общие шаги для Python (пакеты, строки консоли) описаны в статье Как запустить Discord-бота на Python. Эта страница рассказывает о том, чем отличается hikari.
Что мы измерили
Мы запускали каждую библиотеку Discord для Python на своих серверах, в той же конфигурации Python 3.12, которую использует тариф для ботов, с лимитом памяти 1 ГБ:
| Библиотека | Версия | Память в покое | От запуска до ответа Discord |
|---|---|---|---|
| hikari | 2.7.0 | 61 МБ | 1.3 с |
| discord.py | 2.7.1 | 48 МБ | 1.0 с |
| Pycord | 2.8.1 | 51 МБ | 1.1 с |
| nextcord | 3.2.0 | 47 МБ | 1.0 с |
| disnake | 2.12.2 | 47 МБ | 0.9 с |
| Только Python | 3.12 | 9 МБ |
Как мы измеряли: самая маленькая программа, которая загружает библиотеку и входит с поддельным токеном, установленная так, как устанавливают наши серверы. Память показана такой, какой её занимал процесс через 15 секунд после того, как Discord отклонил токен, а время запуска считается от старта до этого ответа, поэтому включает одно обращение к Discord. Каждое значение является медианой трёх запусков после прогревочного запуска. Это нижняя граница: бот, который подключился, вошёл на серверы и закэшировал участников, использует больше, причём насколько именно, зависит от бота.
Что это значит для тарифа: минимальный бот на hikari занимает небольшую часть тарифа STARTER с 0.5 ГБ. Подбирайте тариф по тому, что ваш собственный бот держит в памяти, а не по библиотеке.
Минимальный бот на hikari
Он отвечает на /ping slash-командой и выводит строку готовности. Токен он читает из DISCORD_TOKEN, под этим именем панель передаёт его вашему коду.
requirements.txt
hikari>=2.7,<3
bot.py
import os
import hikari
bot = hikari.GatewayBot(token=os.environ["DISCORD_TOKEN"])
@bot.listen()
async def register_commands(event: hikari.StartedEvent) -> None:
application = await bot.rest.fetch_application()
await bot.rest.set_application_commands(
application=application.id,
commands=[bot.rest.slash_command_builder("ping", "Check that the bot answers")],
)
print(f"Logged in as {bot.get_me()}")
@bot.listen()
async def on_command(event: hikari.CommandInteractionCreateEvent) -> None:
if event.interaction.command_name == "ping":
await event.interaction.create_initial_response(
hikari.ResponseType.MESSAGE_CREATE, "Pong!"
)
bot.run()
hikari выбирает событие по типу, указанному у каждого listener. Когда все шарды запущены (StartedEvent), бот отправляет в Discord список своих команд через set_application_commands, что заменяет глобальные команды бота этим списком, и затем выводит строку готовности. CommandInteractionCreateEvent приходит каждый раз, когда кто-то использует команду. Строка Logged in as переключает индикатор на странице Обзор в состояние Онлайн в Discord.
Если токен неверный
Когда Discord отклоняет токен, hikari выбрасывает такую ошибку (текст, который вывел наш тестовый бот):
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
Это hikari.errors.UnauthorizedError, которое вызывает первый запрос hikari к Discord при запуске бота, после чего бот останавливается. Проверьте токен на странице Бот, в блоке Discord: нажмите Проверить сейчас, и если там написано Discord его не принял, скопируйте новый токен в Discord Developer Portal, Bot, Reset Token, вставьте его через Заменить токен и снова запустите бота. См. Как создать Discord-бота и получить его токен.
Что хосту нужно знать о hikari
- Python 3.11 или новее. hikari 2.7.0 требует Python 3.11 или новее; в его README указано от 3.11 до 3.15. На Python 3.10 простая строка
hikariзаставляет pip установить 2.6.0, последний выпуск для 3.10. Сhikari>=2.7,<3pip отказывается: консоль показывает ошибку pip и[PlayNHost] pip could not install everything in requirements.txt., а если hikari на сервере ещё не был установлен, бот затем останавливается сModuleNotFoundError: No module named 'hikari'. В поле Среда выполнения подходит любой вариант, кроме 3.10. - Фреймворк команд не входит. hikari даёт события и REST API Discord; для команд его README отсылает к lightbulb, tanjun, crescent и arc. Бот выше сам регистрирует свою команду при каждом запуске, что README называет довольно spammy; он советует обработчик команд или проверки, чтобы команды отправлялись только при изменении. Фреймворк означает ещё одну строку в
requirements.txt. - Предупреждение при каждом запуске. hikari пишет в лог
You are running on optimization level 0 (no optimizations)и предлагает-O. На сервере PlayNHost стартовый скрипт запускает ваш файл запуска простымpython, поэтому вы видите это предупреждение, а бот работает нормально. Чтобы скрыть его, передайтеsuppress_optimization_warning=Trueвhikari.GatewayBot(). На собственном VPS можно вместо этого добавить-O. - Логирование и баннер включены по умолчанию.
GatewayBotнастраивает логирование на уровнеINFOи выводит баннер hikari. Собственная строка при подключении шарда выглядит так:shard is ready: ...; индикатор в панели не считает эту строку признаком онлайна, поэтому выводите свою строкуLogged in as, как выше. - Он проверяет обновления. По умолчанию
run()запрашивает у PyPI самую новую версию hikari и пишет в логA newer version of hikari is available, если она есть.bot.run(check_for_updates=False)отключает это. - Интенты. По умолчанию включены все интенты, которые не являются привилегированными. Для чтения текста сообщений нужны
hikari.Intents.MESSAGE_CONTENTвintents=и включённый Message Content Intent в Developer Portal. Если ваш код запрашивает его, а в Portal он выключен, Discord отклоняет вход. См. Как исправить «Used disallowed intents» у вашего Discord-бота.
Свой хостинг на Linux VPS
Сначала проверьте версию Python: python3 --version должна показать 3.11 или новее. В Debian 12 поставляется 3.11, в Ubuntu 24.04 поставляется 3.12, в Debian 13 поставляется 3.13; в Ubuntu 22.04 поставляется 3.10, слишком старая для hikari 2.7. Затем установите Python, создайте пользователя и папку для бота и установите hikari в виртуальное окружение:
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/hikari-bot bot
sudo cp bot.py requirements.txt /opt/hikari-bot/
sudo chown bot: /opt/hikari-bot/bot.py /opt/hikari-bot/requirements.txt
sudo -u bot python3 -m venv /opt/hikari-bot/venv
sudo -u bot /opt/hikari-bot/venv/bin/pip install -r /opt/hikari-bot/requirements.txt
Положите токен в файл, который может читать только root. Создайте /etc/hikari-bot.env командой sudo nano /etc/hikari-bot.env, запишите одну строку, DISCORD_TOKEN= и ваш токен, сохраните файл и выполните sudo chmod 600 /etc/hikari-bot.env.
Затем создайте /etc/systemd/system/hikari-bot.service. Он запускает Python с -O, как рекомендует README hikari для продакшена:
[Unit]
Description=hikari Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/hikari-bot
EnvironmentFile=/etc/hikari-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/hikari-bot/venv/bin/python -O bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
Запустите сервис сейчас и при каждой загрузке системы, затем следите за его выводом:
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1 заставляет print() попадать в журнал сразу, а не когда заполнится буфер. Чтобы обновить бота, скопируйте новые файлы, снова выполните строку pip install и sudo systemctl restart hikari-bot.
Свой сервер или тариф для ботов
| Ваш собственный VPS | Тариф для ботов PlayNHost | |
|---|---|---|
| Python | Версия из вашего дистрибутива, для hikari 2.7 она должна быть 3.11 или новее | Выберите 3.11, 3.12, 3.13 или 3.14 в поле Среда выполнения |
| Пакеты | Вы запускаете pip install после каждого изменения | Устанавливаются при запуске после изменения requirements.txt или версии Python, а также при первом запуске через сутки после последней установки |
| Перезапуски | Ваш юнит systemd | Запускается снова после сбоя; остаётся остановленным с указанием причины, если снова падает в течение минуты |
| Токен | Файл, который вы защищаете сами | Хранится в зашифрованном виде, проверяется в Discord при вставке, передаётся вашему коду как DISCORD_TOKEN |
| Флаги Python | Добавьте -O в ExecStart | Запускается с простым python |
| Обновления системы, файрвол, SSH | Это ваша забота | Не ваша забота |
Частые вопросы
Нужны ли lightbulb, tanjun, crescent или arc?
Нет. Один hikari умеет регистрировать slash-команды и отвечать на них, как показывает бот выше. Фреймворк представляет собой готовый обработчик команд, чтобы вам не писать регистрацию и маршрутизацию самому, когда команд больше нескольких. Добавьте его в requirements.txt; он установится при следующем запуске.
Почему /ping не появляется на моём сервере?
Проверьте, что бот добавлен через Добавить на сервер Discord и что консоль показывает Logged in as: команда регистрируется прямо перед этой строкой. Пока вы тестируете, передайте guild=your_server_id в set_application_commands: тогда команда создаётся только на этом сервере, а в документации Discord сказано, что команды сервера обновляются мгновенно.
Проблема ли предупреждение об оптимизации?
Нет. Оно сообщает, что Python работает без -O, параметра, который убирает инструкции assert и другие проверки, нужные только для отладки, и который hikari советует ради скорости. Ваш бот работает и без него. Скройте предупреждение с помощью suppress_optimization_warning=True.
Помещается ли бот на hikari в самый маленький тариф?
Да. При примерно 61 МБ в нашем тесте минимальный бот на hikari оставляет большую часть тарифа STARTER с 0.5 ГБ для вашего собственного кода. Переходите на тариф побольше, когда это нужно самому боту: большие серверы, участников которых он кэширует, файлы или изображения, которые он обрабатывает, или данные, которые он хранит в памяти.
Готовы запустить своего? Выберите тариф на странице Хостинг Discord-ботов и загрузите своего бота на hikari.



