Welcome to HeyBilly, the Discord voice assistant that brings the power of voice commands to your favorite chat app! Like Alexa, but for Discord, HeyBilly is here to revolutionize your server's voice chat experience.
- Real-Time Data: Ask HeyBilly about what's going on in the world 🌎
- "Hey Billy, what's the weather in Alaska?"
- "Okay Billy, what's the price of gold?"
- YouTube DJ: Play, pause, stop, or resume YouTube videos in voice chat. 🎶
- "Yo Billy, play Lo-Fi music."
- "Hey Billy, play Let It Be by The Beatles."
- "Hey Billy, turn the volume down."
- "Okay Billy, set the volume to 4."
- "Okay Billy, pause music."
- Fun Commands: Videos, GIFs, and coin flips are just a voice command away. 🎲🎥
- "Yo Billy, post a video of a cat."
- "Hey Billy, post a coin flip to the Discord."
- "Hey Billy, post a random number."
- "Okay, Billy, post a funny GIF."
- "Hey Billy, play a cricket sound."
- "Hey Billy, post a scary movie trailer."
- Text-to-Speech (TTS) Support: HeyBilly can speak in the voice chat, making your interactions even more dynamic. 🗣️
Follow these steps to get HeyBilly up and running on your Discord server:
-
Clone the Repository
git clone https://github.com/ZaneH/HeyBilly.git
-
Create a Virtual Environment Use Conda to create a new environment specifically for HeyBilly:
conda create -n heybilly python=3.10 -y
-
Activate the Virtual Environment
conda activate heybilly
-
Install Dependencies Install all the required packages using pip:
pip install -r requirements.txt
-
Setup Environment Variables
Rename
.env.sample
to.env
and populate it with your own API keys. -
Fine-Tune the Model
Go to https://platform.openai.com/finetune and create a new fine-tuning job. Use the files in
./fine_tune_data
to train thegpt-3.5-turbo-1106
model. Once finished, copy the model ID and update your environment variables accordingly. -
Run HeyBilly
python main.py
Invite your bot with the following permissions replacing YOUR_CLIENT_ID
with your bot's client ID:
https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=39584569264128&scope=bot
After setting up, just join a voice channel and use /connect
to make Billy join the voice channel too. Ensure that HeyBilly has the necessary permissions to join and speak in your voice channels.
Other commands include:
/kick
- Disconnects Billy from the voice channel./voice
- Changes Billy's voice./youtube [url]
- Plays a YouTube video in the voice channel./pause
- Pauses the music./resume
- Resumes the music./stop
- Stops the music./playing
- Displays the currently playing YouTube video./volume [0-10]
- Changes the volume of the music.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.
Twitter - @zanehelton
Project Link - https://github.com/ZaneH/HeyBilly
Give a ⭐️ if you like this project!