> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como hospedar um bot discord.py (Python) 24 horas

> Tutorial para hospedar um bot do Discord em Python com discord.py: requirements.txt, arquivo principal, token em variável de ambiente e logs ao vivo.

Neste guia você coloca um bot do Discord feito em Python, com o [discord.py](https://discordpy.readthedocs.io), 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](https://docs.cubehosting.com.br/hosting/templates.md#como-pegar-o-token-do-bot).

> [!TIP]
>
> Prefere começar de um bot pronto? O [template](https://docs.cubehosting.com.br/hosting/templates.md) **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`:

```python main.py theme={"dark"}
import os

import discord
from discord import app_commands

intents = discord.Intents.default()
client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)


@tree.command(name="ping", description="Mostra o tempo de resposta do bot")
async def ping(interaction: discord.Interaction):
    await interaction.response.send_message(f"Pong! {round(client.latency * 1000)} ms")


@client.event
async def on_ready():
    await tree.sync()
    print(f"Logado como {client.user}")


client.run(os.environ["TOKEN"])
```

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.

```text requirements.txt theme={"dark"}
discord.py>=2.7,<3
```

* 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.

```json cube.json theme={"dark"}
{
  "name": "Meu bot",
  "language": "python",
  "version": "3.12",
  "command": "python main.py"
}
```

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](https://docs.cubehosting.com.br/cube-json.md).

**4. Compacte em .zip**

Compacte o **conteúdo** da pasta, sem `venv`, `__pycache__`, `.git` e o seu `.env`.

```bash macOS e Linux theme={"dark"}
cd meu-bot
zip -r meu-bot.zip . -x "venv/*" ".venv/*" "__pycache__/*" ".git/*" ".env"
```

```powershell Windows (PowerShell) theme={"dark"}
cd meu-bot
Compress-Archive -Path main.py, requirements.txt -DestinationPath meu-bot.zip
```

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.

> [!NOTE]
>
> No Free, o `.zip` pode ter até **5 MB**; nos planos pagos, até **10 MB**. Veja [Limites do .zip](https://docs.cubehosting.com.br/hosting/zip-limits.md).

**5. Envie pelo painel**

No [painel](https://app.cubehosting.com.br), 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**.

> [!NOTE]
>
> 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](https://docs.cubehosting.com.br/account/free-plan.md).

**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:

```text Logs › Aplicação theme={"dark"}
Logado como MeuBot#1234
```

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.

> [!NOTE]
>
> 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](https://docs.cubehosting.com.br/hosting/files.md#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**.

| Mensagem | O que é |
| - | - |
| [`ERROR: No matching distribution found`](https://docs.cubehosting.com.br/troubleshooting/app-wont-start#error-no-matching-distribution-found) | Nome ou versão errada no `requirements.txt` |
| [`ModuleNotFoundError: No module named`](https://docs.cubehosting.com.br/troubleshooting/app-wont-start#modulenotfounderror-no-module-named) | O pacote não está no `requirements.txt` |
| [`python: can't open file`](https://docs.cubehosting.com.br/troubleshooting/app-wont-start#python-cant-open-file) | O arquivo principal tem outro nome ou está em outra pasta |
| [`KeyError: 'TOKEN'`](https://docs.cubehosting.com.br/troubleshooting/discord-bots#keyerror-token) | A variável não existe no projeto com o nome que o código lê |
| [`discord.errors.LoginFailure: Improper token has been passed.`](https://docs.cubehosting.com.br/troubleshooting/discord-bots#discord-errors-loginfailure-improper-token-has-been-passed) | O token está errado ou foi trocado no Portal |
| [`discord.errors.PrivilegedIntentsRequired`](https://docs.cubehosting.com.br/troubleshooting/discord-bots#discord-errors-privilegedintentsrequired) | O código pede um intent que não está ligado no Portal |
| [`EOFError: EOF when reading a line`](https://docs.cubehosting.com.br/troubleshooting/app-wont-start#eoferror-eof-when-reading-a-line) | O código chama `input()`, e os logs são só leitura |

O bot está **No ar** e não responde? Veja [No ar, mas não responde](https://docs.cubehosting.com.br/troubleshooting/discord-bots.md#no-ar-mas-não-responde). Todas as mensagens de bot estão em [Erros de bot do Discord](https://docs.cubehosting.com.br/troubleshooting/discord-bots.md).

## 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](https://docs.cubehosting.com.br/hosting/discord-bots.md#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](https://docs.cubehosting.com.br/hosting/environment-variables.md#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](https://docs.cubehosting.com.br/hosting/files.md#onde-o-seu-app-pode-gravar).
* **Bot de música:** o FFmpeg já vem instalado. Para tocar pelo Lavalink, veja [Lavalink](https://docs.cubehosting.com.br/hosting/lavalink.md).

## 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](https://docs.cubehosting.com.br/hosting/discord-bots.md#quando-o-bot-cai) e [Como deixar um bot do Discord online 24 horas](https://docs.cubehosting.com.br/tutorials/discord-bot-online-24-7.md).

## Próximos passos

> [card] [Bots de Discord](https://docs.cubehosting.com.br/hosting/discord-bots.md)
>
> Token, intents, reinício automático e memória.

> [card] [Variáveis de ambiente](https://docs.cubehosting.com.br/hosting/environment-variables.md)
>
> Regras, limites e como importar um `.env`.

Quer ver os planos e os preços? Conheça a [Hospedagem Python](https://cubehosting.com.br/hospedagem-python) e a [Hospedagem de bot Discord](https://cubehosting.com.br/hospedagem-bot-discord) da Cube.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.