.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.
1
Escreva o arquivo principal
Um bot mínimo cabe num arquivo. Este entra no Discord e responde ao comando de barra O token não fica no código: o bot lê da variável de ambiente
/ping:main.py
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 oimporté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]dopyproject.toml.
3
Adicione um cube.json (opcional)
Com um A Cube roda Python 3.11, 3.12 (a padrão), 3.13 e 3.14. Sem
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
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 No Windows, o comando leva só o que está na lista. Acrescente os outros arquivos do seu bot, separados por vírgula (o
venv, __pycache__, .git e o seu .env.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:O
- Instalação: a saída do
pip install. - Aplicação: o que o bot escreve. Quando ele entra no Discord, aparece:
Logs › Aplicaçã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: ligueintents.message_content = Trueno código e o Message Content Intent no Portal. Veja Intents privilegiados. - Usa
python-dotenv? Pode manter oload_dotenv(): sem o arquivo.env, ele não faz nada, e oos.environlê as variáveis do painel. Deixe opython-dotenvnorequirements.txt. - O
.env.examplenã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.
