Per ospitare un bot hikari 24/7, fallo girare su una macchina che resta accesa invece che sul tuo PC: un VPS Linux con un servizio systemd se lo ospiti da te, oppure un piano bot su PlayNHost hosting per bot Discord (da 1,99 US$ al mese), dove carichi il codice, incolli il token e premi Start. Nel nostro test un bot hikari 2.7.0 ha usato circa 61 MB di memoria e ha raggiunto Discord circa 1,3 secondi dopo l'avvio. hikari 2.7 richiede Python 3.11 o successivo e non ha un framework di comandi suo, quindi questa pagina include un comando slash scritto solo con hikari. I passaggi su PlayNHost:
- Nella pagina Hosting per bot Discord, clicca su Crea server su un piano. Nella finestra dell'ordine rispondi a Per quale piattaforma è il tuo bot? con Discord e scegli Python.
- Apri il tuo server nel pannello. La scheda Configura il tuo bot nella Panoramica si apre su Connetti a Discord. Il primo passaggio, Cosa viene eseguito, dovrebbe dire Questo bot esegue Python Bot.; clicca su quel passaggio per verificarlo, poi su Continua.
- In Connetti a Discord, incolla il token in Incolla il token del bot, clicca su Connessione, poi su Sì, continua.
- In Permessi, spunta Il mio codice lo usa solo per gli intent privilegiati che il tuo codice richiede (il bot qui sotto non ne ha bisogno), clicca su Aggiungi a un server Discord, poi su Continua.
- In Il tuo codice, clicca su Carica i file e carica
bot.pye unrequirements.txtche elenchihikari, oppure clicca su Collega Git. - Nella pagina Bot, riquadro Codice, lascia Runtime su Python 3.12 (recommended) oppure scegli 3.11, 3.13 o 3.14 (non 3.10), imposta il File di avvio se non è
bot.pye clicca su Salva. - Clicca su Avvia il bot e guarda la Console. Quando il bot stampa
Logged in as ..., la scheda dice Il tuo bot è online su Discord.
I passaggi generali per Python (pacchetti, righe della console) sono in Come ospitare un bot Discord Python. Questa pagina tratta ciò che cambia con hikari.
Cosa abbiamo misurato
Abbiamo fatto girare ogni libreria Discord per Python sui nostri server, nella stessa configurazione Python 3.12 che usa un piano bot, con un limite di memoria di 1 GB:
| Libreria | Versione | Memoria a riposo | Dall'avvio alla risposta di 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 |
| Solo Python | 3.12 | 9 MB |
Come: il programma più piccolo che carica la libreria e fa il login con un token falso, installato come lo installano i nostri server. La memoria è quella che il processo occupava 15 secondi dopo il rifiuto del token da parte di Discord, e il tempo di avvio va dal lancio a quella risposta, quindi include un viaggio verso Discord. Ogni valore è la mediana di tre esecuzioni dopo una di riscaldamento. È il minimo: un bot che si è connesso, è entrato nei server e ha messo in cache i membri ne usa di più, in misura che dipende dal bot.
Cosa significa per il piano: un bot hikari minimo usa una piccola parte del piano STARTER da 0.5 GB. Dimensiona il piano in base a ciò che il tuo bot tiene in memoria, non in base alla libreria.
Un bot hikari minimo
Risponde a /ping con un comando slash e stampa una riga di pronto. Legge il token da DISCORD_TOKEN, il nome che il pannello dà al tuo codice.
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 sceglie l'evento dal tipo indicato su ogni listener. Quando tutti gli shard sono partiti (StartedEvent), il bot invia a Discord la sua lista di comandi con set_application_commands, che sostituisce i comandi globali del bot con quella lista, poi stampa la riga di pronto. CommandInteractionCreateEvent arriva ogni volta che qualcuno usa un comando. La riga Logged in as porta l'indicatore nella Panoramica su Online su Discord.
Se il token è sbagliato
Quando Discord rifiuta il token, hikari solleva questo errore (il testo stampato dal nostro bot di prova):
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
È una hikari.errors.UnauthorizedError, sollevata dalla prima richiesta di hikari a Discord all'avvio del bot, e il bot si ferma. Controlla il token nella pagina Bot, riquadro Discord: clicca su Verifica ora e, se dice Discord non l’ha accettato, copia un nuovo token nel Discord Developer Portal, Bot, Reset Token, incollalo con Sostituisci il token e riavvia il bot. Vedi Come creare un bot Discord e ottenere il suo token.
Cosa deve sapere un host su hikari
- Python 3.11 o successivo. hikari 2.7.0 richiede Python 3.11 o successivo; il suo README indica da 3.11 a 3.15. Su Python 3.10, una semplice riga
hikarifa installare a pip la 2.6.0, l'ultima versione per 3.10. Conhikari>=2.7,<3pip rifiuta: la console mostra l'errore di pip e[PlayNHost] pip could not install everything in requirements.txt., e se hikari non è mai stato installato sul server, il bot poi si ferma conModuleNotFoundError: No module named 'hikari'. In Runtime va bene qualsiasi scelta tranne 3.10. - Nessun framework di comandi incluso. hikari offre eventi e l'API REST di Discord; il suo README rimanda a lightbulb, tanjun, crescent e arc per i comandi. Il bot qui sopra registra da sé il suo comando a ogni avvio, cosa che il README definisce piuttosto spammy; suggerisce un gestore di comandi, oppure controlli per inviare i comandi solo se sono cambiati. Un framework è una riga in più in
requirements.txt. - Un avviso a ogni avvio. hikari registra
You are running on optimization level 0 (no optimizations)e suggerisce-O. Su un server PlayNHost lo script di avvio esegue il tuo file di avvio con un semplicepython, quindi vedi questo avviso e il bot funziona normalmente. Per nasconderlo, passasuppress_optimization_warning=Trueahikari.GatewayBot(). Sul tuo VPS puoi aggiungere invece-O. - Log e banner sono attivi per impostazione predefinita.
GatewayBotimposta il logging aINFOe stampa il banner di hikari. La sua riga quando uno shard si connette èshard is ready: ...; l'indicatore del pannello non conta quella riga come online, quindi stampa la tua rigaLogged in ascome sopra. - Controlla gli aggiornamenti. Per impostazione predefinita
run()chiede a PyPI l'ultima versione di hikari e registraA newer version of hikari is availablequando ce n'è una.bot.run(check_for_updates=False)lo disattiva. - Intent. L'impostazione predefinita sono tutti gli intent non privilegiati. Leggere il testo dei messaggi richiede
hikari.Intents.MESSAGE_CONTENTinintents=e Message Content Intent attivo nel Developer Portal. Se il tuo codice lo richiede mentre è disattivato nel Portal, Discord rifiuta il login. Vedi Risolvi "Used disallowed intents" sul tuo bot Discord.
Ospitarlo da te su un VPS Linux
Controlla prima la versione di Python: python3 --version deve indicare 3.11 o successiva. Debian 12 include 3.11, Ubuntu 24.04 include 3.12 e Debian 13 include 3.13; Ubuntu 22.04 include 3.10, troppo vecchia per hikari 2.7. Poi installa Python, crea un utente e una cartella per il bot e installa hikari in un ambiente virtuale:
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
Metti il token in un file che solo root può leggere. Crea /etc/hikari-bot.env con sudo nano /etc/hikari-bot.env, scrivi una riga, DISCORD_TOKEN= seguito dal tuo token, salva e lancia sudo chmod 600 /etc/hikari-bot.env.
Poi crea /etc/systemd/system/hikari-bot.service. Esegue Python con -O, come raccomanda il README di hikari per la produzione:
[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
Avvialo subito e a ogni avvio del sistema, poi segui il suo output:
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1 fa arrivare print() subito nel journal invece che quando si riempie un buffer. Per aggiornare il bot, copia i nuovi file, lancia di nuovo la riga pip install e sudo systemctl restart hikari-bot.
Self-hosting o piano bot
| Il tuo VPS | Un piano bot PlayNHost | |
|---|---|---|
| Python | La versione della tua distribuzione, che per hikari 2.7 deve essere 3.11 o successiva | Scegli 3.11, 3.12, 3.13 o 3.14 in Runtime |
| Pacchetti | Lanci pip install dopo ogni modifica | Installati a un avvio dopo che requirements.txt o la versione di Python sono cambiati, e al primo avvio un giorno dopo l'ultima installazione |
| Riavvii | La tua unit systemd | Riavviato dopo un crash; lasciato fermo con il motivo se si blocca di nuovo entro un minuto |
| Il token | Un file che proteggi tu | Conservato cifrato, verificato con Discord quando lo incolli, passato al tuo codice come DISCORD_TOKEN |
| Opzioni di Python | Aggiungi -O in ExecStart | Eseguito con un semplice python |
| Aggiornamenti di sistema, firewall, SSH | Spettano a te | Non sono un tuo compito |
Domande frequenti
Mi servono lightbulb, tanjun, crescent o arc?
No. hikari da solo può registrare e gestire comandi slash, come mostra il bot qui sopra. Un framework è un gestore di comandi già pronto, così non scrivi tu registrazione e instradamento quando hai più di pochi comandi. Aggiungilo a requirements.txt; si installa al prossimo avvio.
Perché /ping non compare nel mio server?
Controlla che il bot sia stato aggiunto con Aggiungi a un server Discord e che la console mostri Logged in as: il comando viene registrato subito prima di quella riga. Mentre provi, passa guild=your_server_id a set_application_commands: il comando viene creato solo in quel server, e la documentazione di Discord dice che i comandi del server si aggiornano subito.
L'avviso sull'ottimizzazione è un problema?
No. Dice che Python gira senza -O, l'opzione che rimuove le istruzioni assert e altri controlli solo di debug, che hikari suggerisce per la velocità . Il tuo bot funziona senza. Nascondi l'avviso con suppress_optimization_warning=True.
Un bot hikari sta nel piano più piccolo?
Sì. Con circa 61 MB nel nostro test, un bot hikari minimo lascia la maggior parte del piano STARTER da 0.5 GB al tuo codice. Passa a un piano più grande quando serve al bot stesso: server grandi di cui mette in cache i membri, file o immagini che elabora, o dati che tiene in memoria.
Pronto a far girare il tuo? Scegli un piano su Hosting per bot Discord e carica il tuo bot hikari.



