Per ospitare un bot Pycord 24/7, fallo girare su una macchina che resta sempre accesa invece che sul tuo PC: un VPS Linux con un servizio systemd se lo ospiti da solo, oppure un piano bot su PlayNHost Discord bot hosting (da 1,99 US$ al mese), dove carichi il codice, incolli il token e premi Avvia. Nel nostro test un bot con Pycord 2.8.1 ha usato circa 51 MB di memoria e ha raggiunto Discord circa 1,1 secondi dopo l'avvio. Pycord si installa come py-cord ma si importa come discord, lo stesso nome di discord.py, quindi indica solo una delle due. I passaggi su PlayNHost:
- Nella pagina Discord bot hosting, 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 indicare Questo bot esegue Python Bot.; clicca su quel passaggio per controllarlo, poi su Continua.
- In Connetti a Discord, incolla il token in Incolla il token del bot, clicca su Collega, poi su Sì, continua.
- In Permessi, spunta Il mio codice lo usa solo per gli intent privilegiati richiesti dal tuo codice (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 elenchipy-cord, oppure clicca su Collega Git. - Se il file principale non è
bot.py, imposta il File di avvio nella pagina Bot, riquadro Codice, e clicca su Salva. - Clicca su Avvia il bot e guarda la Console. Quando il bot stampa
Logged in as ..., la scheda indica Il tuo bot è online su Discord.
I passaggi generali per Python (runtime, pacchetti, righe della console) sono in Come ospitare un bot Discord Python. Questa pagina tratta ciò che cambia con Pycord.
Cosa abbiamo misurato
Abbiamo eseguito ogni libreria Discord per Python sui nostri server, nella stessa configurazione con Python 3.12 usata da un piano bot, con un limite di memoria di 1 GB:
| Libreria | Versione | Memoria a riposo | Dall'avvio alla risposta di Discord |
|---|---|---|---|
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 s |
| hikari | 2.7.0 | 61 MB | 1.3 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 occupata dal processo 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 esecuzione di riscaldamento. È il minimo: un bot che si è connesso, è entrato nei server e ha messo in cache dei membri usa di più, in misura che dipende dal bot.
Cosa significa per il piano: un bot Pycord minimo occupa circa un decimo 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 Pycord minimo
Risponde a /ping con uno slash command e stampa una riga di pronto. Legge il token da DISCORD_TOKEN, il nome che il pannello dà al tuo codice.
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 è la classe di Pycord per gli slash command. Registra /ping su Discord da sola a ogni connessione, perché auto_sync_commands è attivo per impostazione predefinita, quindi non serve scrivere alcun passaggio di sincronizzazione. La riga Logged in as è quella che porta il chip nella Panoramica su Online su Discord.
Se il token è sbagliato
Quando Discord rifiuta il token, Pycord solleva questo errore (il testo stampato dal nostro bot di prova):
LoginFailure: Improper token has been passed.
Con bot.run() un traceback termina con discord.errors.LoginFailure: Improper token has been passed. e il bot si ferma. Il pannello legge quella riga: il chip mostra Problema col token e un banner dice Discord non ha accettato il token del bot. Ottieni un nuovo token nel Discord Developer Portal: la tua applicazione, Bot, Reset Token (viene mostrato una sola volta). Clicca su Sostituisci il token nel banner, poi su Sostituisci il token nel riquadro Discord, incollalo e avvia di nuovo il bot. Vedi Come creare un bot Discord e ottenere il suo token.
Cosa deve sapere un host su Pycord
- Il nome di installazione e quello di importazione sono diversi. Installi
py-corde scriviimport discord. discord.py installa un modulo con lo stesso nome,discord, quindi le due librerie non possono convivere. La guida di Pycord dice di disinstallare prima discord.py e avverte che disinstallare discord.py dopo aver installato py-cord può causare problemi. - Passare un server da discord.py a Pycord. I nostri server installano i pacchetti in una cartella
.locale non rimuovono mai un pacchetto tolto darequirements.txt, quindi discord.py resterebbe accanto a Pycord. In Files, elimina la cartella.locale il file.pnh/packages.state, poi premi Avvia: tutto ciò che è inrequirements.txtviene installato di nuovo, senza discord.py. - Versione di Python. Pycord 2.8.1 supporta Python da 3.10 a 3.14. Il Runtime nel riquadro Codice offre esattamente queste, con 3.12 come predefinita, quindi qualsiasi scelta funziona.
- Intents.
discord.Bot()usa gli intent predefiniti, che non includono nessun intent privilegiato, e gli slash command non ne richiedono. I comandi con prefisso come!pingrichiedonointents.message_content = Truenel tuo codice e Message Content Intent attivo nel Developer Portal. Se il codice lo richiede mentre è disattivato nel Portal, Discord rifiuta il login. Vedi Risolvi "Used disallowed intents" sul tuo bot Discord. - Lascia libero on_connect. La registrazione automatica avviene nell'
on_connectdel bot stesso. Se definisci tuon_connect, la documentazione di Pycord dice di chiamareawait bot.sync_commands()al suo interno, altrimenti i comandi non si aggiornano più. Metti il codice di avvio inon_ready, come sopra. - Il logging è spento finché non lo accendi. Il
run()di Pycord non configura il logging, quindi Python mostra solo gli avvisi e gli errori della libreria, non le sue righe informative come il login. Stampa la tua riga di pronto, come sopra, oppure chiamalogging.basicConfig(level=logging.INFO)per vedere cosa sta facendo la libreria. - Voce. Per i canali vocali, scrivi
py-cord[voice]inrequirements.txtinvece dipy-cord.
Ospitalo tu su un VPS Linux
Su Debian o Ubuntu, installa Python, crea un utente e una cartella per il bot e installa Pycord in un ambiente virtuale:
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
Metti il token in un file leggibile solo da root. Crea /etc/pycord-bot.env con sudo nano /etc/pycord-bot.env, scrivi una riga, DISCORD_TOKEN= seguito dal tuo token, salvala ed esegui sudo chmod 600 /etc/pycord-bot.env.
Poi crea /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
Avvialo subito e a ogni avvio del sistema, poi segui il suo output:
sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 fa arrivare print() nel journal subito, invece di aspettare che un buffer si riempia. Per aggiornare il bot, copia i nuovi file, esegui di nuovo la riga pip install e sudo systemctl restart pycord-bot.
Self-hosting o piano bot
| Il tuo VPS | Un piano bot PlayNHost | |
|---|---|---|
| Python | La versione fornita dalla tua distribuzione; la installi e aggiorni tu | Scegli da 3.10 a 3.14 in Runtime |
| Pacchetti | Esegui 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 va in crash di nuovo entro un minuto |
| Il token | Un file che proteggi tu | Memorizzato cifrato, verificato con Discord quando lo incolli, passato al tuo codice come DISCORD_TOKEN |
| Errori | Leggi il journal | Il banner della console indica la causa, per esempio un token sbagliato o un intent mancante |
| Aggiornamenti di sistema, firewall, SSH | Sono compiti tuoi | Non è compito tuo |
Domande frequenti
Posso avere Pycord e discord.py nello stesso bot?
No. Entrambe installano il modulo discord, quindi una sovrascrive l'altra. Tieni solo py-cord in requirements.txt. Se prima il server eseguiva discord.py, elimina .local e .pnh/packages.state in Files in modo che i pacchetti vengano reinstallati puliti.
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 la riga Logged in as: Pycord registra il comando quando si connette. Mentre provi, passa debug_guilds=[your_server_id] a discord.Bot(): i comandi vengono creati solo in quel server e, secondo la documentazione di Discord, i comandi del server si aggiornano subito.
Pycord è la stessa cosa di discord.py?
No. Pycord è nato come fork di discord.py e conserva gran parte della sua API, come discord.Client e discord.ext.commands, ma i suoi slash command sono diversi: @bot.slash_command e ctx.respond() in Pycord, app_commands e una chiamata di sincronizzazione in discord.py. Il codice scritto per una non sempre funziona con l'altra.
Un bot Pycord sta nel piano più piccolo?
Sì. Con circa 51 MB nel nostro test, un bot Pycord minimo usa circa un decimo del piano STARTER da 0,5 GB. Passa a un piano più grande quando serve al tuo bot: server grandi di cui mette in cache i membri, file o immagini che gestisce, o dati che tiene in memoria.
Pronto a far girare il tuo? Scegli un piano su Discord bot hosting e carica il tuo bot Pycord.



