The gpt-discord-bot repository is an example Discord bot implementation written in Python that integrates OpenAI's language models with Discord servers. The bot leverages the chat completions API to enable conversational interactions with the gpt-3.5-turbo model and incorporates the moderations API to filter potentially problematic messages before they are processed or displayed.
The primary feature of this bot is the /chat command, which initiates a public thread within Discord where users can have conversations with the AI model. When a user invokes this command, they provide an initial message along with optional parameters to adjust the temperature and max_tokens settings, allowing fine-tuning of the model's response behavior. The bot automatically generates replies to every user message posted within threads created through the /chat command. A key capability is that the entire conversation thread is passed to the model with each request, enabling the bot to maintain context and remember previous messages within that thread. The bot includes safeguards that automatically close threads when either the context limit is reached or a maximum message count is exceeded.
Customization options are built into the bot's design. Users can modify bot instructions by editing the config.yaml file, and the default model can be changed from gpt-3.5-turbo to other available models. Additional configuration allows for moderation message routing to specific channels per server, with adjustable moderation sensitivity settings in the constants.py file. The bot depends on the OpenAI Python Library and discord.py for its core functionality.
Bug reports represent the most active issue category with seven tracked items.
The repository explicitly states that it is not accepting feature requests, directing users to fork the repository if they wish to implement new features. Only bug fix pull requests are accepted. The maintainers have established dedicated Discord channels for different types of support: a project post channel for bot-specific problems, an API discussions channel for general OpenAI API questions, and the GitHub issues system for template code bugs. Setup requires Python 3.9 or higher and involves configuring environment variables with OpenAI API keys and Discord bot credentials, along with setting appropriate permissions for the bot within Discord servers.
