Para alojar un bot de hikari 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 Start. En nuestra prueba, un bot de hikari 2.7.0 usó unos 61 MB de memoria y llegó a Discord unos 1,3 segundos después de lanzarse. hikari 2.7 necesita Python 3.11 o superior y no trae un framework de comandos propio, por eso esta página incluye un comando slash escrito solo con hikari. 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 a ¿Para qué plataforma es tu bot? con Discord y elige Python.
- Abre tu servidor en el panel. La tarjeta Configura tu bot del 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 después en Continuar.
- En Conectar con Discord, pega tu token en Pega el token de tu bot, haz clic en Conexión y después 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 después en Continuar.
- En Tu código, haz clic en Subir archivos y sube
bot.pyy unrequirements.txtque incluyahikari, o haz clic en Conectar Git. - En la página Bot, panel Código, deja el Entorno de ejecución en Python 3.12 (recommended) o elige 3.11, 3.13 o 3.14 (no 3.10), indica el Archivo de entrada si no es
bot.pyy 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 (paquetes, líneas de la consola) están en Cómo alojar un bot de Discord en Python. Esta página trata lo que cambia con hikari.
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 |
|---|---|---|---|
| hikari | 2.7.0 | 61 MB | 1.3 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 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 tení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 de calentamiento. Es el mínimo: un bot que se ha conectado, se ha unido a servidores y ha guardado miembros en caché usa más, en una cantidad que depende del bot.
Qué significa para el plan: un bot de hikari mínimo usa una pequeña 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 de hikari mínimo
Responde a /ping con un comando slash e imprime una línea de listo. Lee el token de DISCORD_TOKEN, el nombre que el panel le da a tu código.
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 elige el evento según el tipo de cada listener. Cuando todos los shards han arrancado (StartedEvent), el bot envía su lista de comandos a Discord con set_application_commands, que sustituye los comandos globales del bot por esa lista, y luego imprime la línea de listo. CommandInteractionCreateEvent llega cada vez que alguien usa un comando. La línea Logged in as es la que cambia el chip del Resumen a En línea en Discord.
Si el token es incorrecto
Cuando Discord rechaza el token, hikari lanza este error (el texto que imprimió nuestro bot de prueba):
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
Es un hikari.errors.UnauthorizedError, lanzado por la primera petición de hikari a Discord al arrancar el bot, y el bot se detiene. Revisa el token en la página Bot, panel Discord: haz clic en Comprobar ahora y, si dice Discord no lo aceptó, copia un token nuevo en el Discord Developer Portal, Bot, Reset Token, pégalo con Reemplazar token 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 hikari
- Python 3.11 o superior. hikari 2.7.0 requiere Python 3.11 o posterior; su README indica de 3.11 a 3.15. En Python 3.10, una línea
hikarisin más hace que pip instale 2.6.0, la última versión para 3.10. Conhikari>=2.7,<3, pip se niega: la consola muestra el error de pip y[PlayNHost] pip could not install everything in requirements.txt., y si hikari nunca se instaló en el servidor, el bot se detiene después conModuleNotFoundError: No module named 'hikari'. En Entorno de ejecución, cualquier opción menos 3.10 funciona. - Sin framework de comandos incluido. hikari ofrece eventos y la API REST de Discord; su README remite a lightbulb, tanjun, crescent y arc para los comandos. El bot de arriba registra su comando por sí mismo en cada arranque, algo que el README llama bastante spammy; sugiere un gestor de comandos, o comprobaciones para enviar los comandos solo cuando hayan cambiado. Un framework es una línea más en
requirements.txt. - Un aviso en cada arranque. hikari registra
You are running on optimization level 0 (no optimizations)y sugiere-O. En un servidor de PlayNHost, el script de inicio ejecuta tu archivo de entrada conpythona secas, así que ves este aviso y el bot funciona con normalidad. Para ocultarlo, pasasuppress_optimization_warning=Trueahikari.GatewayBot(). En tu propio VPS puedes añadir-Oen su lugar. - El registro y un banner vienen activados por defecto.
GatewayBotconfigura el registro enINFOe imprime el banner de hikari. Su propia línea cuando un shard se conecta esshard is ready: ...; el chip del panel no cuenta esa línea como en línea, así que imprime tu propia líneaLogged in ascomo arriba. - Comprueba si hay actualizaciones. Por defecto,
run()pregunta a PyPI cuál es el hikari más reciente y registraA newer version of hikari is availablecuando lo hay.bot.run(check_for_updates=False)lo desactiva. - Intents. Por defecto se activan todos los intents que no son privilegiados. Leer el texto de los mensajes requiere
hikari.Intents.MESSAGE_CONTENTenintents=y activar Message Content Intent 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.
Alójalo tú mismo en un VPS Linux
Comprueba primero la versión de Python: python3 --version debe mostrar 3.11 o superior. Debian 12 trae 3.11, Ubuntu 24.04 trae 3.12 y Debian 13 trae 3.13; Ubuntu 22.04 trae 3.10, demasiado antigua para hikari 2.7. Después instala Python, crea un usuario y una carpeta para el bot e instala hikari en un entorno virtual:
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
Guarda el token en un archivo que solo root pueda leer. Crea /etc/hikari-bot.env con sudo nano /etc/hikari-bot.env, escribe una línea, DISCORD_TOKEN= seguido de tu token, guárdalo y ejecuta sudo chmod 600 /etc/hikari-bot.env.
Después crea /etc/systemd/system/hikari-bot.service. Ejecuta Python con -O, como recomienda el README de hikari para producción:
[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
Arráncalo ahora y en cada arranque del sistema, y luego sigue su salida:
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1 hace que print() llegue al journal al instante 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 hikari-bot.
Alojarlo tú o un plan de bots
| Tu propio VPS | Un plan de bots de PlayNHost | |
|---|---|---|
| Python | La versión que trae tu distribución, que debe ser 3.11 o superior para hikari 2.7 | Elige 3.11, 3.12, 3.13 o 3.14 en Entorno de ejecución |
| Paquetes | Ejecutas pip install tras cada cambio | Se instalan en un inicio después de que cambie 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 vuelve a iniciar tras un fallo; se deja detenido con el motivo si falla de nuevo en menos de un minuto |
| El token | Un archivo que proteges tú | Guardado cifrado, comprobado con Discord al pegarlo y entregado a tu código como DISCORD_TOKEN |
| Opciones de Python | Añade -O en ExecStart | Se ejecuta con python a secas |
| Actualizaciones del sistema, firewall, SSH | Te toca a ti | No es cosa tuya |
Preguntas frecuentes
¿Necesito lightbulb, tanjun, crescent o arc?
No. hikari solo puede registrar y responder comandos slash, como muestra el bot de arriba. Un framework es un gestor de comandos ya hecho, así que no escribes tú el registro y el enrutamiento cuando tienes más que unos pocos comandos. Añádelo a requirements.txt; se instala en el siguiente inicio.
¿Por qué no aparece /ping en mi servidor?
Comprueba que el bot se añadió con Añadir a un servidor de Discord y que la consola muestra Logged in as: el comando se registra justo antes de esa línea. Mientras pruebas, pasa guild=your_server_id a set_application_commands: el comando se crea entonces solo en ese servidor, y la documentación de Discord dice que los comandos de servidor se actualizan al instante.
¿Es un problema el aviso de optimización?
No. Dice que Python se ejecuta sin -O, la opción que elimina las instrucciones assert y otras comprobaciones solo de depuración, que hikari sugiere por velocidad. Tu bot funciona sin ella. Oculta el aviso con suppress_optimization_warning=True.
¿Cabe un bot de hikari en el plan más pequeño?
Sí. Con unos 61 MB en nuestra prueba, un bot de hikari mínimo deja casi todo el plan STARTER de 0.5 GB para tu propio código. Sube de plan cuando tu bot mismo 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 hikari.



