Para alojar un bot de Pycord 24/7, ejecútalo en una máquina que siga encendida en lugar de tu PC: un VPS Linux con un servicio de systemd si lo alojas tú mismo, o un plan de bots en el hosting de bots de Discord de PlayNHost (desde US$1.99 al mes), donde subes tu código, pegas el token y pulsas Iniciar. En nuestra prueba, un bot con Pycord 2.8.1 usó unos 51 MB de memoria y llegó a Discord unos 1.1 segundos después de lanzarse. Pycord se instala como py-cord pero se importa como discord, el mismo nombre que discord.py, así que incluye solo una de las dos. Los pasos en PlayNHost:
- En la página de hosting de bots de Discord, haz clic en Crear servidor en un plan. En la ventana del pedido, responde con Discord a ¿Para qué plataforma es tu bot? y elige Python.
- Abre tu servidor en el panel. La tarjeta Configura tu bot en Resumen se abre en Conectar con Discord. Su primer paso, Qué se ejecuta, debería decir Este bot ejecuta Python Bot.; haz clic en ese paso para comprobarlo y luego en Continuar.
- En Conectar con Discord, pega tu token en Pega el token de tu bot, haz clic en Conectar y luego en Sí, continuar.
- En Permisos, marca Mi código lo usa solo para los intents privilegiados que pida tu código (el bot de abajo no necesita ninguno), haz clic en Añadir a un servidor de Discord y luego en Continuar.
- En Tu código, haz clic en Subir archivos y sube
bot.pyy unrequirements.txtque incluyapy-cord, o haz clic en Conectar Git. - Si tu archivo principal no es
bot.py, indica el Archivo de entrada en la página Bot, panel Código, y haz clic en Guardar. - Haz clic en Iniciar bot y mira la Console. Cuando tu bot imprima
Logged in as ..., la tarjeta dirá Tu bot está en línea en Discord.
Los pasos generales de Python (runtime, paquetes, líneas de la consola) están en Cómo alojar un bot de Discord en Python. Esta página explica lo que cambia con Pycord.
Lo que medimos
Ejecutamos cada biblioteca de Discord para Python en nuestros propios servidores, con la misma configuración de Python 3.12 que usa un plan de bots, con un límite de memoria de 1 GB:
| Biblioteca | Versión | Memoria en reposo | Del inicio a la respuesta de 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 |
| Python solo | 3.12 | 9 MB |
Cómo: el programa más pequeño que carga la biblioteca e inicia sesión con un token falso, instalado como lo instalan nuestros servidores. La memoria es la que retenía el proceso 15 segundos después de que Discord rechazara el token, y el tiempo de inicio va desde el lanzamiento hasta esa respuesta, así que incluye un viaje a Discord. Cada cifra es la mediana de tres ejecuciones tras una ejecución de calentamiento. Es el mínimo: un bot que se ha conectado, se ha unido a servidores y tiene miembros en caché usa más, en una cantidad que depende del bot.
Qué significa para el plan: un bot mínimo con Pycord ocupa aproximadamente una décima parte del plan STARTER de 0.5 GB. Dimensiona el plan según lo que tu propio bot guarda en memoria, no según la biblioteca.
Un bot mínimo con Pycord
Responde a /ping con un slash command e imprime una línea de listo. Lee el token de DISCORD_TOKEN, el nombre que el panel da a tu código.
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 es la clase propia de Pycord para slash commands. Registra /ping en Discord por sí sola cada vez que se conecta, porque auto_sync_commands está activado por defecto, así que no hay que escribir ningún paso de sincronización. La línea Logged in as es la que cambia el chip de Resumen a En línea en Discord.
Si el token es incorrecto
Cuando Discord rechaza el token, Pycord lanza este error (el texto que imprimió nuestro bot de prueba):
LoginFailure: Improper token has been passed.
Con bot.run() termina un traceback con discord.errors.LoginFailure: Improper token has been passed. y el bot se detiene. El panel lee esa línea: el chip muestra Problema con el token y un aviso dice Discord no aceptó el token de tu bot. Consigue un token nuevo en el Discord Developer Portal: tu aplicación, Bot, Reset Token (solo se muestra una vez). Haz clic en Reemplazar el token en el aviso, luego en Reemplazar token en el panel Discord, pégalo y vuelve a iniciar el bot. Consulta Cómo crear un bot de Discord y obtener su token.
Lo que un host debe saber sobre Pycord
- El nombre de instalación y el de importación son distintos. Instalas
py-cordy escribesimport discord. discord.py instala un módulo con el mismo nombre,discord, así que no pueden convivir. La propia guía de Pycord dice que hay que desinstalar discord.py primero, y avisa de que desinstalar discord.py después de instalar py-cord puede causar problemas. - Pasar un servidor de discord.py a Pycord. Nuestros servidores instalan los paquetes en una carpeta
.localy nunca eliminan uno que quitas derequirements.txt, así que discord.py seguiría junto a Pycord. En Files, borra la carpeta.localy el archivo.pnh/packages.statey pulsa Iniciar: todo lo derequirements.txtse instala de nuevo, sin discord.py. - Versión de Python. Pycord 2.8.1 admite de Python 3.10 a 3.14. El Entorno de ejecución del panel Código ofrece exactamente esas, con 3.12 por defecto, así que cualquier opción funciona.
- Intents.
discord.Bot()usa los intents por defecto, que no incluyen ninguno privilegiado, y los slash commands no necesitan ninguno. Los comandos con prefijo como!pingnecesitanintents.message_content = Trueen tu código y Message Content Intent activado en el Developer Portal. Si tu código lo pide mientras está desactivado en el Portal, Discord rechaza el inicio de sesión. Consulta Arregla "Used disallowed intents" en tu bot de Discord. - Deja libre on_connect. El registro automático se ejecuta en el
on_connectdel propio bot. Si defineson_connecttú mismo, la documentación de Pycord dice que llames aawait bot.sync_commands()dentro de él, o tus comandos dejarán de actualizarse. Pon el código de arranque enon_ready, como arriba. - El registro de logs está desactivado salvo que lo actives. El
run()de Pycord no configura el logging, así que Python solo muestra las advertencias y los errores de la biblioteca, no sus líneas de información, como el inicio de sesión. Imprime tu propia línea de listo, como arriba, o llama alogging.basicConfig(level=logging.INFO)para ver lo que hace la biblioteca. - Voz. Para los canales de voz, escribe
py-cord[voice]enrequirements.txten lugar depy-cord.
Alójalo tú mismo en un VPS Linux
En Debian o Ubuntu, instala Python, crea un usuario y una carpeta para el bot e instala Pycord en un entorno virtual:
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
Guarda el token en un archivo que solo root pueda leer. Crea /etc/pycord-bot.env con sudo nano /etc/pycord-bot.env, escribe una línea, DISCORD_TOKEN= seguida de tu token, guárdalo y ejecuta sudo chmod 600 /etc/pycord-bot.env.
Después 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
Arráncalo ahora y en cada inicio del sistema, y luego sigue su salida:
sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 hace que print() llegue al journal de inmediato en lugar de cuando se llena un búfer. Para actualizar el bot, copia los archivos nuevos, ejecuta de nuevo la línea de pip install y sudo systemctl restart pycord-bot.
Alojarlo tú o usar un plan de bots
| Tu propio VPS | Un plan de bots de PlayNHost | |
|---|---|---|
| Python | La versión que trae tu distribución; la instalas y actualizas tú | Elige de 3.10 a 3.14 en Entorno de ejecución |
| Paquetes | Ejecutas pip install tras cada cambio | Se instalan en un inicio después de que cambien requirements.txt o la versión de Python, y en el primer inicio un día después de la última instalación |
| Reinicios | Tu unidad de systemd | Se inicia de nuevo tras un fallo; se deja detenido con el motivo si vuelve a fallar en menos de un minuto |
| El token | Un archivo que proteges tú | Se guarda cifrado, se comprueba con Discord al pegarlo y se entrega a tu código como DISCORD_TOKEN |
| Errores | Lees el journal | El aviso de la consola nombra la causa, como un token incorrecto o un intent que falta |
| Actualizaciones del sistema, firewall, SSH | Te tocan a ti | No es tu tarea |
Preguntas frecuentes
¿Puedo tener Pycord y discord.py en el mismo bot?
No. Ambos instalan el módulo discord, así que uno sobrescribe al otro. Deja solo py-cord en requirements.txt. Si el servidor ejecutaba antes discord.py, borra .local y .pnh/packages.state en Files para que los paquetes se instalen de nuevo limpiamente.
¿Por qué /ping no aparece en mi servidor?
Comprueba que el bot se añadió con Añadir a un servidor de Discord y que la consola muestra la línea Logged in as: Pycord registra el comando al conectarse. Mientras pruebas, pasa debug_guilds=[your_server_id] a discord.Bot(): los comandos se crean entonces solo en ese servidor y, según la documentación de Discord, los comandos de servidor se actualizan al instante.
¿Pycord es lo mismo que discord.py?
No. Pycord nació como un fork de discord.py y conserva gran parte de su API, como discord.Client y discord.ext.commands, pero sus slash commands son distintos: @bot.slash_command y ctx.respond() en Pycord, app_commands y una llamada de sincronización en discord.py. El código escrito para una no siempre funciona en la otra.
¿Un bot de Pycord cabe en el plan más pequeño?
Sí. Con unos 51 MB en nuestra prueba, un bot mínimo con Pycord usa aproximadamente una décima parte del plan STARTER de 0.5 GB. Sube de plan cuando tu propio bot lo necesite: servidores grandes cuyos miembros guarda en caché, archivos o imágenes que procesa, o datos que mantiene en memoria.
¿Listo para ejecutar el tuyo? Elige un plan en hosting de bots de Discord y sube tu bot de Pycord.



