Pour héberger un bot hikari 24/7, faites-le tourner sur une machine qui reste allumée plutôt que sur votre PC : un VPS Linux avec un service systemd si vous l'hébergez vous-même, ou une offre bot sur l'hébergement de bots Discord PlayNHost (à partir de 1,99 $US par mois), où vous envoyez votre code, collez le token et cliquez sur Start. Lors de notre test, un bot hikari 2.7.0 a utilisé environ 61 Mo de mémoire et a joint Discord environ 1,3 seconde après son lancement. hikari 2.7 exige Python 3.11 ou plus récent et n'a pas de framework de commandes propre : cette page contient donc une commande slash écrite avec hikari seul. Les étapes sur PlayNHost :
- Sur la page Hébergement de bots Discord, cliquez sur Créer un serveur sur une offre. Dans la fenêtre de commande, répondez à Pour quelle plateforme est votre bot ? par Discord et choisissez Python.
- Ouvrez votre serveur dans le panel. La carte Configurer votre bot de l'Aperçu s'ouvre sur Connexion à Discord. Sa première étape, Ce qui tourne, devrait indiquer Ce bot fait tourner Python Bot. ; cliquez sur cette étape pour le vérifier, puis sur Continuer.
- Sur Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connexion, puis sur Oui, continuer.
- Sur Permissions, cochez Mon code l’utilise uniquement pour les intents privilégiés que demande votre code (le bot ci-dessous n'en a besoin d'aucun), cliquez sur Ajouter à un serveur Discord, puis sur Continuer.
- Sur Votre code, cliquez sur Téléverser des fichiers et envoyez
bot.pyet unrequirements.txtqui contienthikari, ou cliquez sur Connecter Git. - Sur la page Bot, volet Code, laissez le Runtime sur Python 3.12 (recommended) ou choisissez 3.11, 3.13 ou 3.14 (pas 3.10), renseignez le Fichier d’entrée s'il n'est pas
bot.py, puis cliquez sur Enregistrer. - Cliquez sur Démarrer le bot et surveillez la Console. Quand votre bot affiche
Logged in as ..., la carte indique Votre bot est en ligne sur Discord.
Les étapes générales pour Python (paquets, lignes de la console) sont dans Comment héberger un bot Discord Python. Cette page couvre ce qui change avec hikari.
Ce que nous avons mesuré
Nous avons fait tourner chaque bibliothèque Discord pour Python sur nos propres serveurs, dans la même configuration Python 3.12 que celle d'une offre bot, avec une limite de mémoire de 1 Go :
| Bibliothèque | Version | Mémoire au repos | Du démarrage à la réponse de Discord |
|---|---|---|---|
| hikari | 2.7.0 | 61 Mo | 1.3 s |
| discord.py | 2.7.1 | 48 Mo | 1.0 s |
| Pycord | 2.8.1 | 51 Mo | 1.1 s |
| nextcord | 3.2.0 | 47 Mo | 1.0 s |
| disnake | 2.12.2 | 47 Mo | 0.9 s |
| Python seul | 3.12 | 9 Mo |
Méthode : le plus petit programme qui charge la bibliothèque et se connecte avec un faux token, installé comme le font nos serveurs. La mémoire est celle que le processus occupait 15 secondes après le refus du token par Discord, et le temps de démarrage court du lancement à cette réponse, il inclut donc un aller-retour vers Discord. Chaque valeur est la médiane de trois exécutions après une exécution de chauffe. C'est le plancher : un bot qui s'est connecté, a rejoint des serveurs et mis des membres en cache en utilise davantage, dans une mesure qui dépend du bot.
Ce que cela change pour l'offre : un bot hikari minimal n'utilise qu'une petite partie de l'offre STARTER de 0.5 Go. Dimensionnez l'offre selon ce que votre propre bot garde en mémoire, pas selon la bibliothèque.
Un bot hikari minimal
Il répond à /ping avec une commande slash et affiche une ligne de démarrage. Il lit le token dans DISCORD_TOKEN, le nom que le panel donne à votre code.
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 choisit l'événement d'après le type de chaque listener. Quand tous les shards ont démarré (StartedEvent), le bot envoie sa liste de commandes à Discord avec set_application_commands, ce qui remplace les commandes globales du bot par cette liste, puis affiche la ligne de démarrage. CommandInteractionCreateEvent arrive chaque fois que quelqu'un utilise une commande. La ligne Logged in as fait passer la pastille de l'Aperçu à En ligne sur Discord.
Si le token est incorrect
Quand Discord refuse le token, hikari lève cette erreur (le texte qu'a affiché notre bot de test) :
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
C'est une hikari.errors.UnauthorizedError, levée par la première requête de hikari vers Discord au démarrage du bot, et le bot s'arrête. Vérifiez le token sur la page Bot, volet Discord : cliquez sur Vérifier maintenant et, s'il indique Discord ne l’a pas accepté, copiez un nouveau token dans le Discord Developer Portal, Bot, Reset Token, collez-le avec Remplacer le token et redémarrez le bot. Voir Comment créer un bot Discord et obtenir son token.
Ce qu'un hébergeur doit savoir sur hikari
- Python 3.11 ou plus récent. hikari 2.7.0 exige Python 3.11 ou plus ; son README indique de 3.11 à 3.15. Sous Python 3.10, une simple ligne
hikarifait installer par pip la version 2.6.0, la dernière pour 3.10. Avechikari>=2.7,<3, pip refuse : la console affiche l'erreur de pip et[PlayNHost] pip could not install everything in requirements.txt., et si hikari n'a jamais été installé sur le serveur, le bot s'arrête ensuite avecModuleNotFoundError: No module named 'hikari'. Sous Runtime, tous les choix sauf 3.10 conviennent. - Aucun framework de commandes inclus. hikari fournit des événements et l'API REST de Discord ; son README renvoie à lightbulb, tanjun, crescent et arc pour les commandes. Le bot ci-dessus enregistre lui-même sa commande à chaque démarrage, ce que le README juge plutôt spammy ; il suggère un gestionnaire de commandes, ou des vérifications pour n'envoyer les commandes que si elles ont changé. Un framework, c'est une ligne de plus dans
requirements.txt. - Un avertissement à chaque démarrage. hikari journalise
You are running on optimization level 0 (no optimizations)et suggère-O. Sur un serveur PlayNHost, le script de démarrage lance votre fichier d'entrée avec un simplepython: vous voyez donc cet avertissement et le bot fonctionne normalement. Pour le masquer, passezsuppress_optimization_warning=Trueàhikari.GatewayBot(). Sur votre propre VPS, vous pouvez ajouter-Oà la place. - La journalisation et une bannière sont actives par défaut.
GatewayBotconfigure la journalisation au niveauINFOet affiche la bannière de hikari. Sa propre ligne quand un shard se connecte estshard is ready: ...; la pastille du panel ne compte pas cette ligne comme « en ligne », affichez donc votre propre ligneLogged in ascomme ci-dessus. - Il vérifie les mises à jour. Par défaut,
run()demande à PyPI la dernière version de hikari et journaliseA newer version of hikari is availablequand il y en a une.bot.run(check_for_updates=False)désactive cela. - Intents. Par défaut, ce sont tous les intents non privilégiés. Lire le texte des messages demande
hikari.Intents.MESSAGE_CONTENTdansintents=et Message Content Intent activé dans le Developer Portal. Si votre code le demande alors qu'il est désactivé dans le Portal, Discord refuse la connexion. Voir Corriger « Used disallowed intents » sur votre bot Discord.
L'héberger vous-même sur un VPS Linux
Vérifiez d'abord la version de Python : python3 --version doit afficher 3.11 ou plus récent. Debian 12 fournit 3.11, Ubuntu 24.04 fournit 3.12 et Debian 13 fournit 3.13 ; Ubuntu 22.04 fournit 3.10, trop ancien pour hikari 2.7. Installez ensuite Python, créez un utilisateur et un dossier pour le bot, puis installez hikari dans un environnement virtuel :
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
Mettez le token dans un fichier que seul root peut lire. Créez /etc/hikari-bot.env avec sudo nano /etc/hikari-bot.env, écrivez une ligne, DISCORD_TOKEN= suivi de votre token, enregistrez-la et exécutez sudo chmod 600 /etc/hikari-bot.env.
Créez ensuite /etc/systemd/system/hikari-bot.service. Il lance Python avec -O, comme le recommande le README de hikari pour la production :
[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
Démarrez-le maintenant et à chaque démarrage du système, puis suivez sa sortie :
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1 fait arriver print() tout de suite dans le journal au lieu d'attendre qu'un tampon se remplisse. Pour mettre le bot à jour, copiez les nouveaux fichiers, relancez la ligne pip install puis sudo systemctl restart hikari-bot.
Auto-hébergement ou offre bot
| Votre propre VPS | Une offre bot PlayNHost | |
|---|---|---|
| Python | La version de votre distribution, qui doit être 3.11 ou plus récente pour hikari 2.7 | Choisissez 3.11, 3.12, 3.13 ou 3.14 sous Runtime |
| Paquets | Vous lancez pip install après chaque changement | Installés à un démarrage après un changement de requirements.txt ou de version de Python, et au premier démarrage un jour après la dernière installation |
| Redémarrages | Votre unité systemd | Relancé après un plantage ; laissé arrêté avec la raison s'il replante en moins d'une minute |
| Le token | Un fichier que vous protégez vous-même | Stocké chiffré, vérifié auprès de Discord quand vous le collez, transmis à votre code sous le nom DISCORD_TOKEN |
| Options de Python | Ajoutez -O dans ExecStart | Lancé avec un simple python |
| Mises à jour système, pare-feu, SSH | À vous de les faire | Pas votre affaire |
Questions fréquentes
Ai-je besoin de lightbulb, tanjun, crescent ou arc ?
Non. hikari seul peut enregistrer et traiter des commandes slash, comme le montre le bot ci-dessus. Un framework est un gestionnaire de commandes prêt à l'emploi : vous n'écrivez pas vous-même l'enregistrement et le routage dès que vous avez plus que quelques commandes. Ajoutez-le à requirements.txt ; il s'installe au prochain démarrage.
Pourquoi /ping n'apparaît-il pas sur mon serveur ?
Vérifiez que le bot a été ajouté avec Ajouter à un serveur Discord et que la console affiche Logged in as : la commande est enregistrée juste avant cette ligne. Pendant vos tests, passez guild=your_server_id à set_application_commands : la commande n'est alors créée que sur ce serveur, et la documentation de Discord indique que les commandes de serveur se mettent à jour instantanément.
L'avertissement d'optimisation est-il un problème ?
Non. Il signale que Python tourne sans -O, l'option qui supprime les instructions assert et d'autres vérifications réservées au débogage, que hikari suggère pour la vitesse. Votre bot fonctionne sans elle. Masquez l'avertissement avec suppress_optimization_warning=True.
Un bot hikari tient-il dans la plus petite offre ?
Oui. À environ 61 Mo lors de notre test, un bot hikari minimal laisse la plus grande partie de l'offre STARTER de 0.5 Go à votre propre code. Passez à une offre supérieure quand votre bot lui-même en a besoin : grands serveurs dont il met les membres en cache, fichiers ou images qu'il traite, ou données qu'il garde en mémoire.
Prêt à lancer le vôtre ? Choisissez une offre sur Hébergement de bots Discord et envoyez votre bot hikari.



