NUEVO 📢 Black Friday: la oferta de lanzamiento termina el 30 de nov. ¡Hasta un 70% de descuento en tu primer mes!Ver planes
Black FridayHasta un 70% de descuento en tu primer mes, termina el 30 de nov.Termina en 9 d 02 h 49 minBlack FridayHasta un 70% de descuento en tu primer mes, termina el 30 de nov.Termina en 9 d 02 h 49 minBlack FridayHasta un 70% de descuento en tu primer mes, termina el 30 de nov.Termina en 9 d 02 h 49 min

Cómo alojar un bot de hikari 24/7

Hosting de bots de DiscordActualizado 6 nov 202611 min de lectura

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. En Tu código, haz clic en Subir archivos y sube bot.py y un requirements.txt que incluya hikari, o haz clic en Conectar Git.
  6. 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.py y haz clic en Guardar.
  7. 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:

BibliotecaVersiónMemoria en reposoDel inicio a la respuesta de Discord
hikari2.7.061 MB1.3 s
discord.py2.7.148 MB1.0 s
Pycord2.8.151 MB1.1 s
nextcord3.2.047 MB1.0 s
disnake2.12.247 MB0.9 s
Python solo3.129 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 hikari sin más hace que pip instale 2.6.0, la última versión para 3.10. Con hikari>=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 con ModuleNotFoundError: 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 con python a secas, así que ves este aviso y el bot funciona con normalidad. Para ocultarlo, pasa suppress_optimization_warning=True a hikari.GatewayBot(). En tu propio VPS puedes añadir -O en su lugar.
  • El registro y un banner vienen activados por defecto. GatewayBot configura el registro en INFO e imprime el banner de hikari. Su propia línea cuando un shard se conecta es shard is ready: ...; el chip del panel no cuenta esa línea como en línea, así que imprime tu propia línea Logged in as como arriba.
  • Comprueba si hay actualizaciones. Por defecto, run() pregunta a PyPI cuál es el hikari más reciente y registra A newer version of hikari is available cuando 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_CONTENT en intents= 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 VPSUn plan de bots de PlayNHost
PythonLa versión que trae tu distribución, que debe ser 3.11 o superior para hikari 2.7Elige 3.11, 3.12, 3.13 o 3.14 en Entorno de ejecución
PaquetesEjecutas pip install tras cada cambioSe 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
ReiniciosTu unidad de systemdSe vuelve a iniciar tras un fallo; se deja detenido con el motivo si falla de nuevo en menos de un minuto
El tokenUn archivo que proteges túGuardado cifrado, comprobado con Discord al pegarlo y entregado a tu código como DISCORD_TOKEN
Opciones de PythonAñade -O en ExecStartSe ejecuta con python a secas
Actualizaciones del sistema, firewall, SSHTe toca a tiNo 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.

¿Ya tienes tu bot en otro proveedor? Tráelo con nosotros

NUESTROS ÚLTIMOS BLOGS