Pular para o conteúdo principal
Neste guia você coloca um bot do Discord feito em Python, com o discord.py, para rodar 24 horas na Cube. Você envia o código num .zip; a Cube cria o ambiente do Python, instala o que está no requirements.txt e mantém o bot ligado. Você vai precisar de: uma conta na Cube e o token do seu bot. Ainda não tem o token? Veja Como pegar o token do bot.
Prefere começar de um bot pronto? O template Bot discord.py vem com o comando /ping e só pede o token.
1

Escreva o arquivo principal

Um bot mínimo cabe num arquivo. Este entra no Discord e responde ao comando de barra /ping:
main.py
O token não fica no código: o bot lê da variável de ambiente TOKEN, que você preenche no painel.
2

Liste as dependências no requirements.txt

A Cube instala só o que está no requirements.txt, com pip install -r requirements.txt, num ambiente virtual do próprio projeto.
requirements.txt
  • O pacote se chama discord.py, e o import é discord.
  • Coloque ali todo pacote que o código importa (python-dotenv, aiohttp, requests…).
  • Não envie a pasta venv: o ambiente é criado na Cube.
  • Sem requirements.txt, a Cube instala as dependências da seção [project] do pyproject.toml.
3

Adicione um cube.json (opcional)

Com um cube.json na raiz, o painel já sabe a linguagem, a versão e o comando de início. Sem ele, o painel detecta sozinho e você confere antes de enviar.
cube.json
A Cube roda Python 3.11, 3.12 (a padrão), 3.13 e 3.14. Sem memoryMb, o bot entra com o mínimo do plano: 100 MB no Free e 256 MB nos pagos. Veja todas as chaves em O arquivo cube.json.
4

Compacte em .zip

Compacte o conteúdo da pasta, sem venv, __pycache__, .git e o seu .env.
No Windows, o comando leva só o que está na lista. Acrescente os outros arquivos do seu bot, separados por vírgula (o cube.json, se você criou). Se o bot tem pastas, ponha o nome delas na lista também, como cogs: o Compress-Archive leva a pasta com o que está dentro. Ou compacte pelo Explorador de Arquivos: selecione o que está dentro da pasta do bot, menos venv, __pycache__ e o .env, clique com o botão direito e escolha a opção de compactar em ZIP.
No Free, o .zip pode ter até 5 MB; nos planos pagos, até 10 MB. Veja Limites do .zip.
5

Envie pelo painel

No painel, abra Projetos, clique em Novo projeto e arraste o .zip. A tela Configure o projeto mostra o que o painel detectou: Python, a versão, a instalação por pip install -r requirements.txt e o main.py como arquivo principal.Em Variáveis de ambiente, clique em Adicionar variável, escreva TOKEN no nome e cole o token do bot no valor. Ele vai cifrado junto com o envio e chega ao bot antes de ele iniciar.O nome da variável é o que o seu código lê: se o seu bot usa os.environ["DISCORD_TOKEN"], crie a variável como DISCORD_TOKEN.Deixe Iniciar assim que terminar ligado e clique em Enviar e instalar.
No plano Free, pegue antes a sua vaga com o comando /free no Discord da Cube. Sem a vaga, o envio é recusado. Veja Plano Free.
6

Acompanhe a instalação e os logs

O painel mostra o andamento: Enviando, Instalando, Iniciando e No ar. No projeto, a aba Logs tem duas partes:
  • Instalação: a saída do pip install.
  • Aplicação: o que o bot escreve. Quando ele entra no Discord, aparece:
Logs › Aplicação
O print aparece na hora, sem configurar nada.
7

Use o bot no seu servidor

Convide o bot para o seu servidor com os escopos bot e applications.commands e use /ping. O comando aparece logo depois de o bot entrar; se demorar, feche e abra o Discord.
As linhas do próprio discord.py, como discord.client: logging in using static token, aparecem em vermelho nos logs porque ele escreve na saída de erro. Não são erros. Para ficarem na cor normal, troque a última linha por client.run(os.environ["TOKEN"], log_handler=logging.StreamHandler(sys.stdout)), com import logging e import sys no topo.

Atualizar o bot

Mudou o código? Envie um .zip novo em Configurações › Deploy › Enviar um .zip novo. Se o requirements.txt não mudou, a instalação é pulada e o bot volta mais rápido. O .zip novo substitui a pasta inteira do projeto: veja Atualizar o código com um novo .zip. Nos planos pagos, também dá para editar os arquivos na aba Arquivos e clicar em Aplicar mudanças.

Erros mais comuns

Quando algo dá errado, o motivo está nas últimas linhas dos logs. A primeira mensagem da tabela aparece em Logs › Instalação; as outras, em Logs › Aplicação. O bot está No ar e não responde? Veja No ar, mas não responde. Todas as mensagens de bot estão em Erros de bot do Discord.

Dicas para o discord.py

  • Comandos com prefixo (!ajuda) leem o texto das mensagens: ligue intents.message_content = True no código e o Message Content Intent no Portal. Veja Intents privilegiados.
  • Usa python-dotenv? Pode manter o load_dotenv(): sem o arquivo .env, ele não faz nada, e o os.environ lê as variáveis do painel. Deixe o python-dotenv no requirements.txt.
  • O .env.example não é lido. Ele é só um modelo: preencha as variáveis no painel. Veja O modelo de variáveis não é lido.
  • Arquivos que o bot grava (um JSON, um SQLite) ficam na pasta do projeto: use caminhos relativos. Veja Onde o seu app pode gravar.
  • Bot de música: o FFmpeg já vem instalado. Para tocar pelo Lavalink, veja Lavalink.

Quando o bot cai

Nos planos pagos, a Cube liga o bot de novo sozinha e avisa por e-mail. No Free, ele fica Com erro até você iniciar de novo. Veja Quando o bot cai e Como deixar um bot do Discord online 24 horas.

Próximos passos

Bots de Discord

Token, intents, reinício automático e memória.

Variáveis de ambiente

Regras, limites e como importar um .env.
Quer ver os planos e os preços? Conheça a Hospedagem Python e a Hospedagem de bot Discord da Cube.