Orpheus is a Discord music bot built with discord.py voice, yt-dlp, and Spotify Web API calls.

• Python 3.14 or higher
• FFmpeg available on your system path
• Discord and Spotify API credentials in a local .env file
• Docker with Docker Compose support (optional)
• kubectl if you want to deploy the bot to Kubernetes

Create a local .env file with:

• DISCORD_TOKEN
• SPOTIFY_CLIENT_ID
• SPOTIFY_CLIENT_SECRET

For local development:

1. Create and activate a virtual environment.
2. Install dependencies with pip install -r requirements.txt.
3. Start the bot with python bot.py.

For Docker:

1. Build and start the bot in the foreground with docker compose up --build.
2. Build and start the bot in the background with docker compose up -d --build.
3. Follow logs with docker compose logs -f.
4. Stop the service with docker compose down.

For Docker updates:

• Rebuild after dependency or Dockerfile changes with docker compose up --build.
• Restart after Python source changes with docker compose restart.

The included Docker setup:

• uses python:3.14-slim as the base image
• installs ffmpeg inside the container
• loads credentials from .env through docker-compose.yml
• sets PYTHONUNBUFFERED=1 so debug output appears immediately in container logs
• bind-mounts bot.py and src/ into /app for faster local development

For Kubernetes with Docker Desktop:

1. Enable Kubernetes in Docker Desktop and wait for the cluster to become active.
2. Confirm your context is docker-desktop with kubectl config current-context.
3. Build the bot image with docker build -t orpheus:latest ..
4. Create the namespace with kubectl apply -f k8s/namespace.yaml.
5. Create the Kubernetes secret from the local .env file with kubectl create secret generic orpheus-secrets --from-env-file=.env -n orpheus.
6. Apply the Deployment with kubectl apply -f k8s/deployment.yaml.
7. Check resources with kubectl get all -n orpheus.
8. Follow bot logs with kubectl logs -f -n orpheus deployment/orpheus-bot.

To update the Kubernetes deployment after changing the bot code:

1. Rebuild the image with docker build -t orpheus:latest ..
2. Restart the Deployment with kubectl rollout restart deployment/orpheus-bot -n orpheus.
3. Follow the new pod logs with kubectl logs -f -n orpheus deployment/orpheus-bot.

The included Kubernetes setup:

• uses k8s/namespace.yaml to isolate bot resources in the orpheus namespace
• uses k8s/deployment.yaml to run a single bot replica from the orpheus:latest image
• reads DISCORD_TOKEN, SPOTIFY_CLIENT_ID, and SPOTIFY_CLIENT_SECRET from the orpheus-secrets Kubernetes Secret
• includes k8s/secret.example.yaml as a safe template for the required Secret keys
• keeps Python logs unbuffered by setting PYTHONUNBUFFERED=1

• Playback uses discord.py voice, yt-dlp, and Spotify Web API calls.
• Lavalink, Java, and OpenJDK are no longer required for this project.
• .env is intentionally excluded from Docker build context through .dockerignore.
• Run only one copy of the bot at a time. Stop the Docker Compose container before starting the Kubernetes Deployment with the same Discord token.