Skip to main content

Documentation Index

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

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

The Discord integration connects any Agno agent to Discord via the Gateway API. No webhooks required.

​
Quick Start

discord_agent.py
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.integrations.discord import DiscordClient

agent = Agent(name="Assistant", model=OpenAIResponses(id="gpt-5.4"))

discord_client = DiscordClient(agent)

if __name__ == "__main__":
    discord_client.serve()

uv pip install agno discord.py
python discord_agent.py

​
How It Works

ConceptBehavior
GatewayDirect connection to Discord, no webhooks or tunnels needed
ThreadsAuto-creates threads for conversations with isolated context
IntentsRequires Message Content Intent enabled in Developer Portal
PermissionsSend Messages, Read History, Create Threads, Attach Files

​
Setup

Requires a Discord Application with a bot user. See Discord Developer Portal. Environment variables: 
export DISCORD_BOT_TOKEN="..."

​
Next Steps

Full Guide

Bot setup, threads, intents, and permissions.

Examples

Basic agent, media handling, and user memory.

DiscordTools

Give agents channel, message, and reaction capabilities.

Discord Developer Portal

Create and manage your Discord application.