Skip to content

A feature-rich Discord bot built with discord.js that allows you to play music from a Youtube Invidious instance in your Discord server.

Notifications You must be signed in to change notification settings

toolworks-dev/musk-chan

Repository files navigation

Musk-Chan Discord Bot

A feature-rich Discord bot built with discord.js that allows you to play music and chat with AI.

musk

Features

  • 🎵 Play music from YouTube (Uses Invidious Instance) and Soundcloud
  • 🤖 AI Chat powered by Ollama with Short Term and Long Term Memory

Commands

  • /play <query> - Play a song from Youtube or Soundcloud
  • /queue - Display the current music queue
  • /clear - Clear the music queue (keeps current song)
  • /shuffle - Shuffle the current queue
  • /next - Skip to the next song
  • /pause - Pause the current song
  • /stop - Stop playback and clear queue
  • /nowplaying - Shows current song
  • /chat <message> - Chat with Musk-Chan AI
  • /chatsettings clear - Clear your chat history
  • /chatsettings model <name> - Change the AI model
  • /chatsettings listmodels - List available models
  • /chatsettings delete <name> - Delete an AI model

Prerequisites

Setup

  1. Clone the repository
  2. Copy config.json.example to config.json and fill in your Discord bot token and other settings
  3. Start the services:
docker compose up -d
  1. Create the custom AI model:
docker compose exec ollama ollama pull llama3.2:3b-instruct-q5_K_M
docker compose exec ollama ollama create muskchan2 --file Modelfile2

AI Chat

The bot uses Ollama for AI chat functionality. By default, it uses the muskchan2 model (based on llama3.2). You can:

  • Change models using /chatsettings model <name>
  • View available models with /chatsettings listmodels
  • Clear chat history with /chatsettings clear
  • Delete models with /chatsettings delete <name>

To add more models:

  1. Run docker compose exec ollama ollama pull <model>

About

A feature-rich Discord bot built with discord.js that allows you to play music from a Youtube Invidious instance in your Discord server.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published