Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bumbleagi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Setup

1

Create a bot

Go to the Discord Developer Portal, create an application, and generate a bot token.
2

Set the token

In .env at the repo root:
DISCORD_TOKEN=your_token_here
3

Add the platform

In your entity YAML:
presence:
  platforms:
    - type: "discord"
      token_env: "DISCORD_TOKEN"
      channels: ["general"]
4

Invite and run

Invite the bot to your server with appropriate permissions, then:
bumblebee run canary --ollama

​
Configuration

presence:
  platforms:
    - type: "discord"
      token_env: "DISCORD_TOKEN"
      channels: ["general"]               # channels the bot responds in
      # proactive_channel_id: 123456789012345678  # channel for initiative messages
The bot responds in configured channels and DMs. It syncs Discord presence with the entity’s emotional state.

​
Alongside other platforms

You can run Telegram, Discord, and CLI simultaneously. The entity shares memory, body state, and identity across all of them. 
presence:
  platforms:
    - type: "cli"
    - type: "telegram"
      token_env: "TELEGRAM_TOKEN"
    - type: "discord"
      token_env: "DISCORD_TOKEN"
      channels: ["general", "bumblebee"]