Para hospedar um bot hikari 24/7, rode-o em uma máquina que fica sempre ligada em vez de no seu PC: um VPS Linux com um serviço systemd, se você hospeda por conta própria, ou um plano de bots na hospedagem de bots do Discord da PlayNHost (a partir de US$1,99 por mês), onde você envia seu código, cola o token e clica em Start. No nosso teste, um bot hikari 2.7.0 usou cerca de 61 MB de memória e alcançou o Discord cerca de 1,3 segundo depois de iniciado. O hikari 2.7 exige Python 3.11 ou mais recente e não tem framework de comandos próprio, por isso esta página inclui um comando slash escrito só com hikari. Os passos na PlayNHost:
- Na página de hospedagem de bots do Discord, clique em Criar servidor em um plano. Na janela do pedido, responda a Para qual plataforma é o seu bot? com Discord e escolha Python.
- Abra seu servidor no painel. O cartão Configurar seu bot na Visão geral abre em Conectar ao Discord. O primeiro passo, O que roda, deve dizer Este bot roda Python Bot.; clique nesse passo para conferir e depois em Continuar.
- Em Conectar ao Discord, cole seu token em Cole o token do seu bot, clique em Conectar e depois em Sim, continuar.
- Em Permissões, marque Meu código usa isto apenas para os intents privilegiados que seu código pede (o bot abaixo não precisa de nenhum), clique em Adicionar a um servidor do Discord e depois em Continuar.
- Em Seu código, clique em Enviar arquivos e envie
bot.pye umrequirements.txtque listehikari, ou clique em Conectar o Git. - Na página Bot, painel Código, deixe o Runtime em Python 3.12 (recommended) ou escolha 3.11, 3.13 ou 3.14 (não 3.10), defina o Arquivo de entrada se não for
bot.pye clique em Salvar. - Clique em Iniciar bot e acompanhe o Console. Quando seu bot imprimir
Logged in as ..., o cartão dirá Seu bot está online no Discord.
Os passos gerais de Python (pacotes, linhas do console) estão em Como hospedar um bot do Discord em Python. Esta página cobre o que muda com o hikari.
O que medimos
Rodamos cada biblioteca de Discord para Python em nossos próprios servidores, na mesma configuração de Python 3.12 que um plano de bots usa, com limite de memória de 1 GB:
| Biblioteca | Versão | Memória em repouso | Do início à resposta do Discord |
|---|---|---|---|
| hikari | 2.7.0 | 61 MB | 1.3 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 s |
| Só Python | 3.12 | 9 MB |
Como: o menor programa que carrega a biblioteca e faz login com um token falso, instalado do jeito que nossos servidores instalam. A memória é a que o processo ocupava 15 segundos depois de o Discord recusar o token, e o tempo de início vai do lançamento até essa resposta, então inclui uma ida ao Discord. Cada valor é a mediana de três execuções após uma execução de aquecimento. É o piso: um bot que se conectou, entrou em servidores e guardou membros em cache usa mais, em uma quantidade que depende do bot.
O que isso significa para o plano: um bot hikari mínimo usa uma pequena parte do plano STARTER de 0.5 GB. Dimensione o plano pelo que o seu próprio bot guarda na memória, não pela biblioteca.
Um bot hikari mínimo
Ele responde a /ping com um comando slash e imprime uma linha de pronto. Lê o token de DISCORD_TOKEN, o nome que o painel dá ao seu código.
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()
O hikari escolhe o evento pelo tipo em cada listener. Quando todos os shards iniciaram (StartedEvent), o bot envia sua lista de comandos ao Discord com set_application_commands, o que substitui os comandos globais do bot por essa lista, e depois imprime a linha de pronto. CommandInteractionCreateEvent chega toda vez que alguém usa um comando. A linha Logged in as faz o indicador da Visão geral mudar para Online no Discord.
Se o token estiver errado
Quando o Discord recusa o token, o hikari lança este erro (o texto que nosso bot de teste imprimiu):
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
É um hikari.errors.UnauthorizedError, lançado pela primeira requisição do hikari ao Discord quando o bot inicia, e o bot para. Confira o token na página Bot, painel Discord: clique em Verificar agora e, se aparecer O Discord não aceitou, copie um novo token no Discord Developer Portal, Bot, Reset Token, cole-o com Substituir token e inicie o bot de novo. Veja Como criar um bot do Discord e obter o token.
O que um host precisa saber sobre o hikari
- Python 3.11 ou mais recente. O hikari 2.7.0 exige Python 3.11 ou posterior; o README indica de 3.11 a 3.15. No Python 3.10, uma linha
hikarisimples faz o pip instalar a 2.6.0, a última versão para 3.10. Comhikari>=2.7,<3, o pip recusa: o console mostra o erro do pip e[PlayNHost] pip could not install everything in requirements.txt., e se o hikari nunca foi instalado no servidor, o bot para depois comModuleNotFoundError: No module named 'hikari'. Em Runtime, qualquer escolha exceto 3.10 funciona. - Sem framework de comandos incluído. O hikari oferece eventos e a API REST do Discord; o README indica lightbulb, tanjun, crescent e arc para comandos. O bot acima registra o próprio comando a cada início, o que o README chama de bastante spammy; ele sugere um gerenciador de comandos ou verificações para enviar os comandos só quando mudaram. Um framework é uma linha a mais em
requirements.txt. - Um aviso a cada início. O hikari registra
You are running on optimization level 0 (no optimizations)e sugere-O. Em um servidor PlayNHost, o script de início roda seu arquivo de entrada compythonsimples, então você vê esse aviso e o bot funciona normalmente. Para escondê-lo, passesuppress_optimization_warning=Trueparahikari.GatewayBot(). No seu próprio VPS, você pode adicionar-Ono lugar. - Logs e um banner vêm ativados por padrão.
GatewayBotconfigura o log emINFOe imprime o banner do hikari. A linha própria quando um shard conecta éshard is ready: ...; o indicador do painel não conta essa linha como online, então imprima sua própria linhaLogged in ascomo acima. - Ele verifica atualizações. Por padrão,
run()pergunta ao PyPI qual é o hikari mais novo e registraA newer version of hikari is availablequando há um.bot.run(check_for_updates=False)desativa isso. - Intents. O padrão são todos os intents que não são privilegiados. Ler o texto das mensagens exige
hikari.Intents.MESSAGE_CONTENTemintents=e o Message Content Intent ligado no Developer Portal. Se seu código pedir isso enquanto está desligado no Portal, o Discord recusa o login. Veja Corrigir "Used disallowed intents" no seu bot do Discord.
Hospede você mesmo em um VPS Linux
Confira primeiro a versão do Python: python3 --version deve mostrar 3.11 ou mais recente. O Debian 12 traz 3.11, o Ubuntu 24.04 traz 3.12 e o Debian 13 traz 3.13; o Ubuntu 22.04 traz 3.10, antigo demais para o hikari 2.7. Depois instale o Python, crie um usuário e uma pasta para o bot e instale o hikari em um ambiente virtual:
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
Coloque o token em um arquivo que só o root possa ler. Crie /etc/hikari-bot.env com sudo nano /etc/hikari-bot.env, escreva uma linha, DISCORD_TOKEN= seguido do seu token, salve e execute sudo chmod 600 /etc/hikari-bot.env.
Depois crie /etc/systemd/system/hikari-bot.service. Ele roda o Python com -O, como o README do hikari recomenda para produção:
[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
Inicie-o agora e em cada boot, depois acompanhe a saída:
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1 faz print() chegar ao journal na hora, em vez de quando um buffer enche. Para atualizar o bot, copie os arquivos novos, execute de novo a linha pip install e sudo systemctl restart hikari-bot.
Hospedagem própria ou plano de bots
| Seu próprio VPS | Um plano de bots da PlayNHost | |
|---|---|---|
| Python | A versão da sua distribuição, que precisa ser 3.11 ou mais recente para o hikari 2.7 | Escolha 3.11, 3.12, 3.13 ou 3.14 em Runtime |
| Pacotes | Você executa pip install após cada mudança | Instalados em um início depois que requirements.txt ou a versão do Python muda, e no primeiro início um dia depois da última instalação |
| Reinícios | Sua unidade systemd | Iniciado de novo após uma falha; deixado parado com o motivo se falhar de novo em menos de um minuto |
| O token | Um arquivo que você protege por conta própria | Guardado criptografado, verificado com o Discord quando você o cola, entregue ao seu código como DISCORD_TOKEN |
| Opções do Python | Adicione -O em ExecStart | Roda com python simples |
| Atualizações do sistema, firewall, SSH | Ficam por sua conta | Não é tarefa sua |
Perguntas frequentes
Preciso de lightbulb, tanjun, crescent ou arc?
Não. O hikari sozinho consegue registrar e responder comandos slash, como o bot acima mostra. Um framework é um gerenciador de comandos pronto, para você não escrever o registro e o roteamento quando tiver mais do que alguns comandos. Adicione-o ao requirements.txt; ele é instalado no próximo início.
Por que o /ping não aparece no meu servidor?
Confira se o bot foi adicionado com Adicionar a um servidor do Discord e se o console mostra Logged in as: o comando é registrado logo antes dessa linha. Enquanto testa, passe guild=your_server_id para set_application_commands: o comando é então criado só nesse servidor, e a documentação do Discord diz que comandos de servidor são atualizados na hora.
O aviso de otimização é um problema?
Não. Ele diz que o Python roda sem -O, a opção que remove instruções assert e outras verificações só de depuração, que o hikari sugere por velocidade. Seu bot funciona sem ela. Esconda o aviso com suppress_optimization_warning=True.
Um bot hikari cabe no menor plano?
Sim. Com cerca de 61 MB no nosso teste, um bot hikari mínimo deixa a maior parte do plano STARTER de 0.5 GB para o seu próprio código. Suba de plano quando o seu bot mesmo precisar: servidores grandes cujos membros ele guarda em cache, arquivos ou imagens que ele processa, ou dados que ele mantém na memória.
Pronto para rodar o seu? Escolha um plano em hospedagem de bots do Discord e envie seu bot hikari.



