NOUVEAU 📢 Black Friday : l'offre de lancement finit le 30 nov. Jusqu'à 70 % de remise sur votre premier mois !Voir les offres
Black FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 minBlack FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 minBlack FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 min

Héberger un bot hikari 24/7 : le faire tourner sans interruption

Hébergement de bots DiscordMis à jour 6 nov. 202611 min de lecture

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 :

  1. 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.
  2. 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.
  3. Sur Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connexion, puis sur Oui, continuer.
  4. 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.
  5. Sur Votre code, cliquez sur Téléverser des fichiers et envoyez bot.py et un requirements.txt qui contient hikari, ou cliquez sur Connecter Git.
  6. 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.
  7. 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èqueVersionMémoire au reposDu démarrage à la réponse de Discord
hikari2.7.061 Mo1.3 s
discord.py2.7.148 Mo1.0 s
Pycord2.8.151 Mo1.1 s
nextcord3.2.047 Mo1.0 s
disnake2.12.247 Mo0.9 s
Python seul3.129 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 hikari fait installer par pip la version 2.6.0, la dernière pour 3.10. Avec hikari>=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 avec ModuleNotFoundError: 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 simple python : vous voyez donc cet avertissement et le bot fonctionne normalement. Pour le masquer, passez suppress_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. GatewayBot configure la journalisation au niveau INFO et affiche la bannière de hikari. Sa propre ligne quand un shard se connecte est shard is ready: ... ; la pastille du panel ne compte pas cette ligne comme « en ligne », affichez donc votre propre ligne Logged in as comme ci-dessus.
  • Il vérifie les mises à jour. Par défaut, run() demande à PyPI la dernière version de hikari et journalise A newer version of hikari is available quand 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_CONTENT dans intents= 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 VPSUne offre bot PlayNHost
PythonLa version de votre distribution, qui doit être 3.11 ou plus récente pour hikari 2.7Choisissez 3.11, 3.12, 3.13 ou 3.14 sous Runtime
PaquetsVous lancez pip install après chaque changementInstallé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émarragesVotre unité systemdRelancé après un plantage ; laissé arrêté avec la raison s'il replante en moins d'une minute
Le tokenUn fichier que vous protégez vous-mêmeStocké chiffré, vérifié auprès de Discord quand vous le collez, transmis à votre code sous le nom DISCORD_TOKEN
Options de PythonAjoutez -O dans ExecStartLancé avec un simple python
Mises à jour système, pare-feu, SSHÀ vous de les fairePas 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.

Votre bot est hébergé ailleurs ? Transférez-le chez nous

NOS DERNIERS ARTICLES