Skip to content

A GPT-based Discord bot that uses OpenAI models to provide chat-based interactions with users in Discord channels and via DMs.

License

Notifications You must be signed in to change notification settings

nitintecg/DiscordianAI

 
 

Repository files navigation

GitHub Stars Flake8 and Pytest CodeQL License: Unlicense

Description

This is a Python script for a Discord bot that uses OpenAI's GPT API to generate responses to user messages. The bot can be configured to listen to specific channels and respond to direct messages. The bot also has a rate limit to prevent spamming and can maintain a per user conversational history to improve response quality which is only limited by the GPT_TOKENS value.

Requirements

  • Bash
  • Python 3.6 or Higher
  • Python Modules
    • discord.py
    • openai

Installation

  1. Clone the repository to your local machine.
  2. Install the required packages using pip: pip install -r requirements.txt
  3. Rename config.ini.example to config.ini and fill in the required configuration details.

Configuration

The config.ini file contains the following configuration sections:

Discord

  • DISCORD_TOKEN: The Discord bot token.
  • ALLOWED_CHANNELS: A comma-separated list of channel names that the bot is allowed to listen to.
  • BOT_PRESENCE: The presence of the bot (e.g. online, offline, idle).
  • ACTIVITY_TYPE: The type of activity for the bot (e.g. playing, streaming, listening, watching, custom, competing).
  • ACTIVITY_STATUS: The activity status of the bot (e.g. Humans).

OpenAI

  • OPENAI_API_KEY: The OpenAI API key.
  • OPENAI_TIMEOUT: The OpenAI API timeout in seconds. (default: 30)
  • GPT_MODEL: The GPT model to use (default: gpt-3.5-turbo).
  • GPT_TOKENS: The maximum number of tokens to generate in the GPT response (default: 3072).
  • SYSTEM_MESSAGE: The message to send to the GPT model before the user's message.

Limits

  • RATE_LIMIT: The number of messages a user can send within RATE_LIMIT_PER seconds (default: 2).
  • RATE_LIMIT_PER: The time period in seconds for the rate limit (default: 10).

Logging

  • LOG_FILE: The path to the log file (default: bot.log).

Here is an example config.ini file:

[Discord]
DISCORD_TOKEN = <your_discord_bot_token>
ALLOWED_CHANNELS = <allowed_channel_id_1>, <allowed_channel_id_2>, ...
BOT_PRESENCE = online
# ACTIVITY_TYPE Options
# playing, streaming, listening, watching, custom, competing
ACTIVITY_TYPE=listening
ACTIVITY_STATUS=Humans

[OpenAI]
OPENAI_API_KEY = <your_openai_api_key>
OPENAI_TIMEOUT=30
GPT_MODEL=gpt-3.5-turbo
GPT_TOKENS=3072
SYSTEM_MESSAGE = You are a helpful AI assistant.

[Limits]
RATE_LIMIT = 2
RATE_LIMIT_PER = 10

[Logging]
LOG_FILE = bot.log

Discord Bot Setup

To use this bot, you will need to create a Discord bot and invite it to your server. Here are the steps to do so:

  1. Go to the Discord Developer Portal and create a new application.
  2. Click on the "Bot" tab and then click "Add Bot".
  3. Copy the bot token and paste it into the DISCORD_TOKEN field in the config.ini file.
  4. Under the "OAuth2" tab, select the "bot" scope and then select the permissions you want the bot to have.
  5. Copy the generated OAuth2 URL and paste it into your web browser. This will allow you to invite the bot to your server.

Usage

To start the bot, run the following command:

python bot.py --conf config.ini

The bot will log in to Discord and start listening for messages in the configured channels. When a message is received, the bot will send the message to the OpenAI API and wait for a response. The response will be sent back to the user who sent the message.

Daemon Control Script

discordian.sh is a bash script for launching a DiscordianAI bot with customizable configurations. It is suitable for both manual execution and running via crontab.

Features

  • Strict error checking: The script exits on any error and recognizes failures in pipelines.
  • Logging: The script logs events with timestamps for better tracking.
  • Customizable configurations: The script allows for different modes of operation and configurations.
  • Error Handling: It logs errors and exits on failure.
  • Process Handling: It terminates existing instances of the bot before starting a new one.

Usage

The script accepts the following command line arguments:

  • -d or --daemon: Runs the bot in daemon mode with no output to the terminal.
  • -c or --config: Allows the use of a custom configuration file. The next argument should be the path to the configuration file.
  • -f or --folder: Allows the use of a base folder. The next argument should be the path to the base folder.

Daemon Example

./discordian.sh -d -c /path/to/config.ini -f /path/to/base/folder

This command will run the bot in daemon mode, using the configuration file at /path/to/config.ini and the base folder at /path/to/base/folder.

Contributing

Contributions are welcome! Please open an issue or pull request on the GitHub repository.

Contact

If you have any questions or concerns, please contact us at [email protected]

License

This project is licensed under the Unlicense - see the LICENSE file for details.

About

A GPT-based Discord bot that uses OpenAI models to provide chat-based interactions with users in Discord channels and via DMs.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 85.1%
  • Shell 14.9%