Om een hikari-bot 24/7 te hosten, laat je hem draaien op een machine die aan blijft in plaats van op je pc: een Linux-VPS met een systemd-service als je zelf host, of een botabonnement bij PlayNHost Discord-bothosting (vanaf US$1.99 per maand), waar je je code uploadt, het token plakt en op Start drukt. In onze test gebruikte een hikari 2.7.0-bot ongeveer 61 MB geheugen en bereikte hij Discord ongeveer 1,3 seconden na het starten. hikari 2.7 heeft Python 3.11 of nieuwer nodig en heeft geen eigen commandoframework, dus deze pagina bevat een slash-commando dat alleen met hikari is geschreven. De stappen bij PlayNHost:
- Klik op de pagina Discord-bothosting bij een abonnement op Server aanmaken. Beantwoord in het bestelvenster Voor welk platform is je bot? met Discord en kies Python.
- Open je server in het paneel. De kaart Je bot instellen op het Overzicht opent bij Verbinden met Discord. De eerste stap, Wat er draait, hoort Deze bot draait Python Bot. te tonen; klik op die stap om het te controleren en dan op Doorgaan.
- Plak bij Verbinden met Discord je token in Plak je bottoken, klik op Verbinden en dan op Ja, doorgaan.
- Vink bij Rechten Mijn code gebruikt dit alleen aan voor de bevoorrechte intents die je code vraagt (de bot hieronder heeft er geen nodig), klik op Toevoegen aan een Discord-server en dan op Doorgaan.
- Klik bij Je code op Bestanden uploaden en upload
bot.pyen eenrequirements.txtwaarinhikaristaat, of klik op Git koppelen. - Laat op de pagina Bot, paneel Code, de Runtime op Python 3.12 (recommended) staan of kies 3.11, 3.13 of 3.14 (niet 3.10), stel het Startbestand in als het niet
bot.pyis en klik op Opslaan. - Klik op Bot starten en bekijk de Console. Als je bot
Logged in as ...afdrukt, zegt de kaart Je bot is online in Discord.
De algemene Python-stappen (pakketten, consoleregels) staan in Een Python Discord-bot hosten. Deze pagina behandelt wat er bij hikari anders is.
Wat we hebben gemeten
We hebben elke Python-Discordbibliotheek op onze eigen servers laten draaien, in dezelfde Python 3.12-opzet die een botabonnement gebruikt, met een geheugenlimiet van 1 GB:
| Bibliotheek | Versie | Geheugen in rust | Start tot antwoord van 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 |
| Alleen Python | 3.12 | 9 MB |
Hoe: het kleinst mogelijke programma dat de bibliotheek laadt en inlogt met een nep-token, geïnstalleerd zoals onze servers het installeren. Het geheugen is wat het proces 15 seconden nadat Discord het token weigerde in gebruik had, en de starttijd loopt van het starten tot dat antwoord, dus er zit één reis naar Discord in. Elke waarde is de mediaan van drie runs na een opwarmrun. Het is de ondergrens: een bot die verbonden is, servers is binnengegaan en leden heeft gecachet, gebruikt meer, met een hoeveelheid die van de bot afhangt.
Wat het voor het abonnement betekent: een minimale hikari-bot gebruikt een klein deel van het STARTER-abonnement van 0.5 GB. Kies het abonnement op basis van wat je eigen bot in het geheugen houdt, niet op basis van de bibliotheek.
Een minimale hikari-bot
Hij antwoordt op /ping met een slash-commando en drukt een gereedregel af. Hij leest het token uit DISCORD_TOKEN, de naam die het paneel aan je code geeft.
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 kiest het event op basis van het type bij elke listener. Als alle shards gestart zijn (StartedEvent), stuurt de bot zijn commandolijst met set_application_commands naar Discord, wat de globale commando's van de bot door die lijst vervangt, en drukt dan de gereedregel af. CommandInteractionCreateEvent komt binnen telkens als iemand een commando gebruikt. De regel Logged in as zet het label op het Overzicht op Online in Discord.
Als het token fout is
Als Discord het token weigert, geeft hikari deze fout (de tekst die onze testbot afdrukte):
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
Het is een hikari.errors.UnauthorizedError, veroorzaakt door het eerste verzoek van hikari aan Discord bij het starten van de bot, en de bot stopt. Controleer het token op de pagina Bot, paneel Discord: klik op Nu controleren en als er Discord heeft het niet geaccepteerd staat, kopieer dan een nieuw token in het Discord Developer Portal, Bot, Reset Token, plak het met Token vervangen en start de bot opnieuw. Zie Een Discord-bot maken en zijn token ophalen.
Wat een host over hikari moet weten
- Python 3.11 of nieuwer. hikari 2.7.0 vereist Python 3.11 of later; de README noemt 3.11 tot 3.15. Op Python 3.10 laat een kale
hikari-regel pip 2.6.0 installeren, de laatste release voor 3.10. Methikari>=2.7,<3weigert pip: de console toont de fout van pip en[PlayNHost] pip could not install everything in requirements.txt., en als hikari nog nooit op de server is geïnstalleerd, stopt de bot daarna metModuleNotFoundError: No module named 'hikari'. Onder Runtime werkt elke keuze behalve 3.10. - Geen commandoframework inbegrepen. hikari geeft je events en de REST-API van Discord; de README verwijst voor commando's naar lightbulb, tanjun, crescent en arc. De bot hierboven registreert zijn commando bij elke start zelf, wat de README nogal spammy noemt; die stelt een commandohandler voor, of controles zodat de commando's alleen worden verstuurd als ze veranderd zijn. Een framework is één regel extra in
requirements.txt. - Een waarschuwing bij elke start. hikari logt
You are running on optimization level 0 (no optimizations)en stelt-Ovoor. Op een PlayNHost-server draait het startscript je startbestand met kalepython, dus je ziet deze waarschuwing en de bot werkt normaal. Om haar te verbergen geef jesuppress_optimization_warning=Truemee aanhikari.GatewayBot(). Op je eigen VPS kun je in plaats daarvan-Otoevoegen. - Logging en een banner staan standaard aan.
GatewayBotzet logging opINFOen drukt de hikari-banner af. De eigen regel als een shard verbindt isshard is ready: ...; het label in het paneel telt die regel niet als online, dus druk zoals hierboven je eigenLogged in as-regel af. - Hij zoekt naar updates. Standaard vraagt
run()aan PyPI naar de nieuwste hikari en logtA newer version of hikari is availableals die er is.bot.run(check_for_updates=False)zet dat uit. - Intents. Standaard zijn dat alle intents die niet bevoorrecht zijn. Het lezen van berichttekst vraagt
hikari.Intents.MESSAGE_CONTENTinintents=en Message Content Intent aan in het Developer Portal. Als je code erom vraagt terwijl het in het Portal uit staat, weigert Discord de login. Zie "Used disallowed intents" oplossen op je Discord-bot.
Zelf hosten op een Linux-VPS
Controleer eerst de Python-versie: python3 --version moet 3.11 of nieuwer zeggen. Debian 12 levert 3.11, Ubuntu 24.04 levert 3.12 en Debian 13 levert 3.13; Ubuntu 22.04 levert 3.10, te oud voor hikari 2.7. Installeer dan Python, maak een gebruiker en een map voor de bot en installeer hikari in een virtuele omgeving:
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
Zet het token in een bestand dat alleen root kan lezen. Maak /etc/hikari-bot.env met sudo nano /etc/hikari-bot.env, schrijf één regel, DISCORD_TOKEN= gevolgd door je token, sla op en voer sudo chmod 600 /etc/hikari-bot.env uit.
Maak dan /etc/systemd/system/hikari-bot.service. Het draait Python met -O, zoals de README van hikari voor productie aanraadt:
[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
Start het nu en bij elke boot en volg dan de uitvoer:
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1 zorgt dat print() meteen in de journal komt in plaats van pas als een buffer vol raakt. Om de bot bij te werken kopieer je de nieuwe bestanden, voer je de regel pip install opnieuw uit en daarna sudo systemctl restart hikari-bot.
Zelf hosten of een botabonnement
| Je eigen VPS | Een PlayNHost-botabonnement | |
|---|---|---|
| Python | De versie van je distributie, die voor hikari 2.7 3.11 of nieuwer moet zijn | Kies 3.11, 3.12, 3.13 of 3.14 onder Runtime |
| Pakketten | Jij voert na elke wijziging pip install uit | Geïnstalleerd bij een start nadat requirements.txt of de Python-versie is gewijzigd, en bij de eerste start een dag na de laatste installatie |
| Herstarts | Je systemd-unit | Na een crash opnieuw gestart; met de reden gestopt gelaten als hij binnen een minuut opnieuw crasht |
| Het token | Een bestand dat je zelf beschermt | Versleuteld opgeslagen, bij het plakken met Discord gecontroleerd, aan je code gegeven als DISCORD_TOKEN |
| Python-opties | Voeg -O toe in ExecStart | Draait met kale python |
| Systeemupdates, firewall, SSH | Doe je zelf | Niet jouw taak |
Veelgestelde vragen
Heb ik lightbulb, tanjun, crescent of arc nodig?
Nee. hikari alleen kan slash-commando's registreren en beantwoorden, zoals de bot hierboven laat zien. Een framework is een kant-en-klare commandohandler, zodat je registratie en routering niet zelf schrijft zodra je meer dan een paar commando's hebt. Voeg het toe aan requirements.txt; het wordt bij de volgende start geïnstalleerd.
Waarom verschijnt /ping niet in mijn server?
Controleer of de bot is toegevoegd met Toevoegen aan een Discord-server en of de console Logged in as toont: het commando wordt vlak voor die regel geregistreerd. Geef tijdens het testen guild=your_server_id mee aan set_application_commands: het commando wordt dan alleen in die server aangemaakt, en volgens de documentatie van Discord worden servercommando's direct bijgewerkt.
Is de optimalisatiewaarschuwing een probleem?
Nee. Ze zegt dat Python zonder -O draait, de optie die assert-statements en andere alleen-debugcontroles verwijdert en die hikari voor snelheid voorstelt. Je bot werkt zonder. Verberg de waarschuwing met suppress_optimization_warning=True.
Past een hikari-bot in het kleinste abonnement?
Ja. Met ongeveer 61 MB in onze test laat een minimale hikari-bot het grootste deel van het STARTER-abonnement van 0.5 GB over voor je eigen code. Stap over naar een groter abonnement als je bot zelf dat nodig heeft: grote servers waarvan hij de leden cachet, bestanden of afbeeldingen die hij verwerkt, of gegevens die hij in het geheugen houdt.
Klaar om de jouwe te draaien? Kies een abonnement op Discord-bothosting en upload je hikari-bot.



