warshanks / discord-bots

A repo for my Discord bots

Discord Bots

Table of Contents

• Overview
• Features
• Commands
  • 🏎️F1 Related
  • 🖼️Image Generation
  • 🎵Music
  • 🗣️Text-to-Speech Conversations
  • 💬Text-to-Text Conversations
  • 🌩️Weather
  • 🔭Astronomy
• Dependencies
• Getting Started
• Usage

Overview

This repository hosts the source code for my Discord bots, including KC, the Lilith variant, and a Ferrari-themed F1 data bot. The bots are developed using Python 3.11 and integrate several libraries and APIs to provide a feature-rich experience.

Features

• Engages in text-to-text conversations using OpenAI's GPT-4, retaining the last 15 messages in the channel

• Generates text-to-speech audio from text-to-text conversations using the ElevenLabs API

• Generates images with Stability.AI's Stable Diffusion and OpenAI's Dall-E models

• F1 telemetry analysis using Fast-F1

KC also features a music player, weather information, and more!

Commands

F1 Related

/data-dump - Generates a data dump for a given year, event, session, and optionally a specific lap in .CSV format
/driver-comparison - Compares two driver's telemetry given a year, event, session, and optionally a specific lap
/gear-map - Generates a gear map for a given year, event, session, and optionally a specific lap
/strat - Generates a meme Ferrari strategy
/year-vs-year - Compares telemetry between two years for a given event and session
/next - Displays the next F1 event schedule
/next-f2 - Displays the next F2 event schedule
/wdc-standings - Displays the current World Drivers' Championship standings
/wcc-standings - Displays the current World Constructors' Championship standings
/can-win-wdc - Displays the drivers who can still win the WDC

Image Generation

/dall-e - Generates an image using OpenAI's Dall-E API using a given prompt
/stable - Generates an image using Stability.AI's Stable Diffusion API using a given prompt, and 5 optional parameters

Music

/clear - Clears the current queue
/leave - Leaves the voice channel
/pause - Pauses the current song
/play [url]/<search terms> - Plays music from a YouTube URL or search terms
/queue - Displays the current queue
/resume - Resumes the current song
/skip - Skips the current song

Text-to-Speech Conversations

/join - Joins the voice channel
/tts-kick - Kicks the bot from the voice channel

Text-to-Text Conversations

/hype - Generates a hype emojipasta about a given prompt

Weather

/weather - Displays the current weather for a given location
/outlook - Pulls the Day 1 convective outlook from the Storm Prediction Center
/radar-loop - Pulls the latest radar loop for the Mississippi Valley from the National Weather Service
/bmx-radar - Pulls the latest loop from the BMX radar from the National Weather Service

Astronomy

/apod - Pulls the Astronomy Picture of the Day from NASA

Dependencies

To run the KC Discord bot, ensure you have the following packages installed:

aiohttp==3.8.4
discord.py==2.2.3
elevenlabs==0.2.17
fastf1==3.0.3
icalendar==5.0.7
openai==0.27.7
Pillow==9.5.0
PyNaCl==1.5.0
pyowm==3.3.0
setuptools==67.8.0
stability_sdk==0.8.1
supervisor==4.2.5
youtube-dl (from master branch!)

Getting Started

1. Clone the repository or download the source code.
2. Install the required dependencies as listed in the Dependencies section:

   pip install -r requirements.txt
   

3. Obtain necessary API keys and tokens for OpenAI, Stability.AI, ElevenLabs, and Discord.
4. Update the configuration files with the obtained keys and tokens.
5. Follow the usage instructions below to run the bot.

Usage

To run the KC Discord bot, simply run the following command:

Windows

./docker.ps1

Linux

python3.11 kc.py