Para hospedar um bot Pycord 24/7, rode-o em uma máquina que fique sempre ligada em vez de no seu PC: um VPS Linux com um serviço systemd, se você mesmo hospeda, ou um plano de bots na hospedagem de bots do Discord da PlayNHost (a partir de US$1,99 por mês), onde você envia seu código, cola o token e clica em Iniciar. Em nosso teste, um bot com Pycord 2.8.1 usou cerca de 51 MB de memória e chegou ao Discord cerca de 1,1 segundo depois de ser iniciado. O Pycord é instalado como py-cord, mas você o importa como discord, o mesmo nome do discord.py, então liste só uma das duas. Os passos na PlayNHost:
- Na página de hospedagem de bots do Discord, clique em Criar servidor em um plano. Na janela do pedido, responda Para qual plataforma é o seu bot? com Discord e escolha Python.
- Abra seu servidor no painel. O cartão Configurar seu bot na Visão geral abre em Conectar ao Discord. O primeiro passo, O que roda, deve dizer Este bot roda Python Bot.; clique nesse passo para conferir e depois em Continuar.
- Em Conectar ao Discord, cole seu token em Cole o token do seu bot, clique em Conectar e depois em Sim, continuar.
- Em Permissões, marque Meu código usa isto apenas para os intents privilegiados que seu código pede (o bot abaixo não precisa de nenhum), clique em Adicionar a um servidor do Discord e depois em Continuar.
- Em Seu código, clique em Enviar arquivos e envie
bot.pye umrequirements.txtque listepy-cord, ou clique em Conectar o Git. - Se o seu arquivo principal não for
bot.py, defina o Arquivo de entrada na página Bot, painel Código, e clique em Salvar. - Clique em Iniciar bot e acompanhe o Console. Quando seu bot imprimir
Logged in as ..., o cartão mostra Seu bot está online no Discord.
Os passos gerais de Python (runtime, pacotes, linhas do console) estão em Como hospedar um bot do Discord em Python. Esta página cobre o que muda com o Pycord.
O que medimos
Rodamos cada biblioteca de Discord para Python em nossos próprios servidores, na mesma configuração com Python 3.12 que um plano de bots usa, com limite de memória de 1 GB:
| Biblioteca | Versão | Memória em repouso | Do início à resposta do 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 |
| Só o Python | 3.12 | 9 MB |
Como: o menor programa que carrega a biblioteca e faz login com um token falso, instalado do jeito que nossos servidores instalam. A memória é a que o processo ocupava 15 segundos depois de o Discord recusar o token, e o tempo de início vai do lançamento até essa resposta, então inclui uma ida ao Discord. Cada valor é a mediana de três execuções após uma execução de aquecimento. É o piso: um bot que já conectou, entrou em servidores e guardou membros em cache usa mais, em uma quantidade que depende do bot.
O que isso significa para o plano: um bot Pycord mínimo ocupa cerca de um décimo do plano STARTER de 0,5 GB. Dimensione o plano pelo que o seu próprio bot guarda na memória, não pela biblioteca.
Um bot Pycord mínimo
Ele responde a /ping com um slash command e imprime uma linha de pronto. Lê o token de DISCORD_TOKEN, o nome que o painel dá ao seu 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 é a classe própria do Pycord para slash commands. Ela registra /ping no Discord sozinha a cada conexão, porque auto_sync_commands vem ativado por padrão, então não há etapa de sincronização para escrever. A linha Logged in as é o que muda o chip na Visão geral para Online no Discord.
Se o token estiver errado
Quando o Discord recusa o token, o Pycord gera este erro (o texto que nosso bot de teste imprimiu):
LoginFailure: Improper token has been passed.
Com bot.run(), um traceback termina com discord.errors.LoginFailure: Improper token has been passed. e o bot para. O painel lê essa linha: o chip mostra Problema no token e um banner diz O Discord não aceitou o token do seu bot. Gere um novo token no Discord Developer Portal: sua aplicação, Bot, Reset Token (ele é mostrado uma única vez). Clique em Substituir o token no banner, depois em Substituir token no painel Discord, cole-o e inicie o bot de novo. Veja Como criar um bot do Discord e obter o token.
O que um host precisa saber sobre o Pycord
- O nome de instalação e o de importação são diferentes. Você instala
py-corde escreveimport discord. O discord.py instala um módulo com o mesmo nome,discord, então os dois não podem coexistir. O guia do próprio Pycord manda desinstalar o discord.py primeiro e avisa que desinstalar o discord.py depois de instalar o py-cord pode causar problemas. - Mover um servidor do discord.py para o Pycord. Nossos servidores instalam pacotes em uma pasta
.locale nunca removem um que você tira dorequirements.txt, então o discord.py ficaria ao lado do Pycord. Em Files, apague a pasta.locale o arquivo.pnh/packages.statee depois clique em Iniciar: tudo que está norequirements.txté instalado de novo, sem o discord.py. - Versão do Python. O Pycord 2.8.1 oferece suporte ao Python 3.10 a 3.14. O Runtime no painel Código oferece exatamente essas versões, com 3.12 como padrão, então qualquer escolha funciona.
- Intents.
discord.Bot()usa os intents padrão, que não incluem nenhum privilegiado, e os slash commands não precisam de nenhum. Comandos com prefixo, como!ping, precisam deintents.message_content = Trueno seu código e do Message Content Intent ativado no Developer Portal. Se o seu código o pede enquanto ele está desativado no Portal, o Discord recusa o login. Veja Corrigir "Used disallowed intents" no seu bot do Discord. - Deixe o on_connect livre. O registro automático roda no
on_connectdo próprio bot. Se você definiron_connectpor conta própria, a documentação do Pycord manda chamarawait bot.sync_commands()dentro dele, ou seus comandos deixam de ser atualizados. Coloque o código de inicialização emon_ready, como acima. - O logging fica desligado a menos que você o ligue. O
run()do Pycord não configura o logging, então o Python mostra só os avisos e erros da biblioteca, não as linhas de informação dela, como o login. Imprima sua própria linha de pronto, como acima, ou chamelogging.basicConfig(level=logging.INFO)para ver o que a biblioteca está fazendo. - Voz. Para canais de voz, escreva
py-cord[voice]norequirements.txtem vez depy-cord.
Hospede você mesmo em um VPS Linux
No Debian ou no Ubuntu, instale o Python, crie um usuário e uma pasta para o bot e instale o Pycord em um ambiente 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
Coloque o token em um arquivo que só o root possa ler. Crie /etc/pycord-bot.env com sudo nano /etc/pycord-bot.env, escreva uma linha, DISCORD_TOKEN= seguido do seu token, salve e execute sudo chmod 600 /etc/pycord-bot.env.
Depois crie /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
Inicie-o agora e a cada boot, e depois acompanhe a saída:
sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 faz o print() chegar ao journal na hora, em vez de só quando um buffer enche. Para atualizar o bot, copie os novos arquivos, execute a linha do pip install de novo e sudo systemctl restart pycord-bot.
Hospedagem própria ou plano de bots
| Seu próprio VPS | Um plano de bots da PlayNHost | |
|---|---|---|
| Python | A versão que a sua distribuição traz; você instala e atualiza | Escolha de 3.10 a 3.14 em Runtime |
| Pacotes | Você executa pip install a cada mudança | Instalados em uma inicialização depois que requirements.txt ou a versão do Python mudam, e na primeira inicialização um dia após a última instalação |
| Reinícios | Sua unidade systemd | Iniciado de novo após uma falha; deixado parado, com o motivo, se falhar outra vez em menos de um minuto |
| O token | Um arquivo que você protege por conta própria | Guardado criptografado, verificado no Discord quando você o cola e entregue ao seu código como DISCORD_TOKEN |
| Erros | Você lê o journal | O banner do console indica a causa, como um token errado ou um intent ausente |
| Atualizações do sistema, firewall, SSH | Ficam por sua conta | Não é tarefa sua |
Perguntas frequentes
Posso ter o Pycord e o discord.py no mesmo bot?
Não. Os dois instalam o módulo discord, então um sobrescreve o outro. Mantenha só o py-cord no requirements.txt. Se o servidor rodava o discord.py antes, apague .local e .pnh/packages.state em Files para que os pacotes sejam instalados de novo do zero.
Por que o /ping não aparece no meu servidor?
Confira se o bot foi adicionado com Adicionar a um servidor do Discord e se o console mostra a linha Logged in as: o Pycord registra o comando quando se conecta. Enquanto você testa, passe debug_guilds=[your_server_id] para discord.Bot(): os comandos são então criados só nesse servidor e, segundo a documentação do Discord, comandos de servidor são atualizados na hora.
O Pycord é o mesmo que o discord.py?
Não. O Pycord começou como um fork do discord.py e mantém boa parte da API dele, como discord.Client e discord.ext.commands, mas os slash commands são diferentes: @bot.slash_command e ctx.respond() no Pycord, app_commands e uma chamada de sincronização no discord.py. O código escrito para um nem sempre roda no outro.
Um bot Pycord cabe no menor plano?
Sim. Com cerca de 51 MB em nosso teste, um bot Pycord mínimo usa cerca de um décimo do plano STARTER de 0,5 GB. Suba de plano quando o seu bot precisar: servidores grandes cujos membros ele guarda em cache, arquivos ou imagens que ele processa, ou dados que ele mantém na memória.
Pronto para rodar o seu? Escolha um plano na hospedagem de bots do Discord e envie seu bot Pycord.



