Pour héberger un bot Pycord 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 un forfait 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 appuyez sur Démarrer. Lors de notre test, un bot Pycord 2.8.1 a utilisé environ 51 Mo de mémoire et a joint Discord environ 1,1 seconde après son lancement. Pycord s'installe sous le nom py-cord mais s'importe sous le nom discord, le même que discord.py : n'indiquez donc qu'une seule des deux. Les étapes sur PlayNHost :
- Sur la page d'hébergement de bots Discord, cliquez sur Créer un serveur pour un forfait. 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, doit indiquer Ce bot fait tourner Python Bot. ; cliquez sur cette étape pour la vérifier, puis sur Continuer.
- À l'étape Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connecter, puis sur Oui, continuer.
- À l'étape 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.
- À l'étape Votre code, cliquez sur Téléverser des fichiers et envoyez
bot.pyet unrequirements.txtqui listepy-cord, ou cliquez sur Connecter Git. - Si votre fichier principal n'est pas
bot.py, définissez le Fichier d’entrée sur la page Bot, volet Code, 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 (runtime, paquets, lignes de la console) se trouvent dans Comment héberger un bot Discord Python. Cette page couvre ce qui change avec Pycord.
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'un forfait 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 |
|---|---|---|---|
| Pycord | 2.8.1 | 51 Mo | 1.1 s |
| discord.py | 2.7.1 | 48 Mo | 1.0 s |
| nextcord | 3.2.0 | 47 Mo | 1.0 s |
| disnake | 2.12.2 | 47 Mo | 0.9 s |
| hikari | 2.7.0 | 61 Mo | 1.3 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 nos serveurs l'installent. 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 d'échauffement. C'est le plancher : un bot qui s'est connecté, a rejoint des serveurs et mis des membres en cache consomme davantage, dans une mesure qui dépend du bot.
Ce que cela signifie pour le forfait : un bot Pycord minimal occupe environ un dixième du forfait STARTER de 0,5 Go. Dimensionnez le forfait selon ce que votre propre bot garde en mémoire, pas selon la bibliothèque.
Un bot Pycord minimal
Il répond à /ping avec une slash command et affiche une ligne de démarrage. Il lit le token dans DISCORD_TOKEN, le nom que le panel donne à votre code.
requirements.txt
py-cord>=2.8,<3
bot.py
import os
import discord
bot = discord.Bot()
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.slash_command(name="ping", description="Check that the bot answers")
async def ping(ctx: discord.ApplicationContext):
await ctx.respond("Pong!")
bot.run(os.environ["DISCORD_TOKEN"])
discord.Bot est la classe propre à Pycord pour les slash commands. Elle enregistre /ping auprès de Discord toute seule à chaque connexion, car auto_sync_commands est activé par défaut : il n'y a donc aucune étape de synchronisation à écrire. 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, Pycord lève cette erreur (le texte affiché par notre bot de test) :
LoginFailure: Improper token has been passed.
Avec bot.run(), une trace d'erreur se termine par discord.errors.LoginFailure: Improper token has been passed. et le bot s'arrête. Le panel lit cette ligne : la pastille affiche Problème de token et une bannière indique Discord n’a pas accepté le token de votre bot. Obtenez un nouveau token dans le Discord Developer Portal : votre application, Bot, Reset Token (il n'est affiché qu'une fois). Cliquez sur Remplacer le token dans la bannière, puis sur Remplacer le token dans le volet Discord, collez-le et redémarrez le bot. Voir Comment créer un bot Discord et obtenir son token.
Ce qu'un hébergeur doit savoir sur Pycord
- Le nom d'installation et le nom d'import diffèrent. Vous installez
py-cordet écrivezimport discord. discord.py installe un module du même nom,discord, les deux ne peuvent donc pas coexister. Le guide de Pycord lui-même demande de désinstaller discord.py d'abord, et prévient que désinstaller discord.py après avoir installé py-cord peut causer des problèmes. - Passer un serveur de discord.py à Pycord. Nos serveurs installent les paquets dans un dossier
.localet ne retirent jamais un paquet que vous enlevez derequirements.txt: discord.py resterait donc à côté de Pycord. Dans Files, supprimez le dossier.localet le fichier.pnh/packages.state, puis appuyez sur Démarrer : tout ce qui est dansrequirements.txts'installe de nouveau, sans discord.py. - Version de Python. Pycord 2.8.1 prend en charge Python 3.10 à 3.14. Le Runtime du volet Code propose exactement celles-ci, avec 3.12 par défaut : tout choix fonctionne.
- Intents.
discord.Bot()utilise les intents par défaut, qui n'incluent aucun intent privilégié, et les slash commands n'en demandent aucun. Les commandes à préfixe comme!pingexigentintents.message_content = Truedans votre code 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. - Laissez on_connect libre. L'enregistrement automatique s'exécute dans le
on_connectdu bot lui-même. Si vous définissez vous-mêmeon_connect, la documentation de Pycord demande d'y appelerawait bot.sync_commands(), faute de quoi vos commandes ne se mettent plus à jour. Placez le code de démarrage danson_ready, comme plus haut. - Les logs sont désactivés tant que vous ne les activez pas. Le
run()de Pycord ne configure pas la journalisation : Python n'affiche donc que les avertissements et erreurs de la bibliothèque, pas ses lignes d'information comme la connexion. Affichez votre propre ligne de démarrage, comme plus haut, ou appelezlogging.basicConfig(level=logging.INFO)pour voir ce que fait la bibliothèque. - Vocal. Pour les salons vocaux, écrivez
py-cord[voice]dansrequirements.txtau lieu depy-cord.
L'héberger vous-même sur un VPS Linux
Sous Debian ou Ubuntu, installez Python, créez un utilisateur et un dossier pour le bot, puis installez Pycord dans un environnement virtuel :
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/pycord-bot bot
sudo cp bot.py requirements.txt /opt/pycord-bot/
sudo chown bot: /opt/pycord-bot/bot.py /opt/pycord-bot/requirements.txt
sudo -u bot python3 -m venv /opt/pycord-bot/venv
sudo -u bot /opt/pycord-bot/venv/bin/pip install -r /opt/pycord-bot/requirements.txt
Placez le token dans un fichier que seul root peut lire. Créez /etc/pycord-bot.env avec sudo nano /etc/pycord-bot.env, écrivez une ligne, DISCORD_TOKEN= suivi de votre token, enregistrez-la et exécutez sudo chmod 600 /etc/pycord-bot.env.
Créez ensuite /etc/systemd/system/pycord-bot.service :
[Unit]
Description=Pycord Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/pycord-bot
EnvironmentFile=/etc/pycord-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/pycord-bot/venv/bin/python 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 pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 fait arriver print() dans le journal immédiatement, au lieu d'attendre qu'un tampon soit plein. Pour mettre le bot à jour, copiez les nouveaux fichiers, relancez la ligne pip install puis sudo systemctl restart pycord-bot.
Auto-hébergement ou forfait bot
| Votre propre VPS | Un forfait bot PlayNHost | |
|---|---|---|
| Python | La version fournie par votre distribution ; vous l'installez et la mettez à jour | Choisissez de 3.10 à 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 dans la 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 |
| Erreurs | Vous lisez le journal | La bannière de la console nomme la cause, par exemple un mauvais token ou un intent manquant |
| Mises à jour système, pare-feu, SSH | À votre charge | Pas votre travail |
Questions fréquentes
Puis-je avoir Pycord et discord.py dans le même bot ?
Non. Les deux installent le module discord : l'un écrase l'autre. Ne gardez que py-cord dans requirements.txt. Si le serveur faisait tourner discord.py auparavant, supprimez .local et .pnh/packages.state dans Files pour que les paquets s'installent de nouveau proprement.
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 la ligne Logged in as : Pycord enregistre la commande à la connexion. Pendant vos tests, passez debug_guilds=[your_server_id] à discord.Bot() : les commandes ne sont alors créées que sur ce serveur et, selon la documentation de Discord, les commandes de serveur se mettent à jour instantanément.
Pycord est-il la même chose que discord.py ?
Non. Pycord est né comme un fork de discord.py et conserve une grande partie de son API, comme discord.Client et discord.ext.commands, mais ses slash commands diffèrent : @bot.slash_command et ctx.respond() dans Pycord, app_commands et un appel de synchronisation dans discord.py. Le code écrit pour l'une ne fonctionne pas toujours avec l'autre.
Un bot Pycord tient-il dans le plus petit forfait ?
Oui. Avec environ 51 Mo lors de notre test, un bot Pycord minimal occupe environ un dixième du forfait STARTER de 0,5 Go. Passez au forfait supérieur quand votre bot 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 un forfait sur l'hébergement de bots Discord et envoyez votre bot Pycord.



