A Discord bot for music lovers

---

Sonata is a Discord bot that brings RateYourMusic ratings to your Discord server. Share your music taste, discover new albums, and explore what your community is listening to!

📖 Documentation

Full documentation is available at: Sonata Documentation

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• Discord Bot Token
• Last.fm API Key
• Genius API Token

Installation

1. Clone the repository

git clone https://github.com/hsc00/sonata-bot.git
cd sonata-bot

2. Install dependencies

pip install -r requirements.txt
# or
just install

3. Configure environment variables

Create a .env file with your API keys:

DISCORD_TOKEN=your_discord_bot_token
LASTFM_API_KEY=your_lastfm_api_key
LASTFM_API_SECRET=your_lastfm_api_secret
GENIUS_API_TOKEN=your_genius_token

4. Run the bot

python bot/bot.py
# or
just run

See the full setup guide for detailed instructions.

🛠️ Development

Uses Just for task automation:

just setup      # Setup development environment
just run        # Run the bot
just lint       # Check code quality
just format     # Format code
just docs-serve # Serve documentation locally