A feature-rich Discord bot designed to enhance your server experience. Complete with economy, moderation, music integration, and utility commands.
- 💰 Economy System: Virtual currency, gambling, jobs, and daily rewards
- 🛡️ Advanced Moderation: Comprehensive user management with warnings and role automation
- 🎵 Last.fm Integration: Real-time music tracking and server-wide now playing
- 📊 Leveling System: XP-based progression with leaderboards and rewards
- ⚙️ Admin Tools: Custom embeds, reaction roles, and bulk management
- 🎯 Utilities: Birthday tracking, timezone management, and quotes
1. Create your configuration:
# Clone the repository git clone https://github.com/IM23d/leurs.git cd leurs # Copy and configure environment file cp .env.template .env # Edit .env with your bot token and API keys2. Create a compose.yml file:
services: leurs: build: context: .dockerfile: Dockerfilecontainer_name: leurs-botenv_file: - .envrestart: unless-stopped3. Start the bot:
docker compose up -d# Clone and setup git clone https://github.com/IM23d/leurs.git cd leurs # Create virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate# Install dependencies pip install -r requirements.txt # Configure environment cp .env.template .env # Edit .env with your credentials# Run the bot python main.pyConfigure your .env file with the following:
# Discord bot token (Required)DISCORD_TOKEN=your_discord_bot_token # Last.fm API (Optional - for music features)LAST_FM_KEY=your_lastfm_api_key # Google Custom Search API (Optional - for image search)GOOGLE_API_KEY=your_google_api_key GOOGLE_CSE_ID=your_google_cse_id # DeepSeek API (Optional - for AI features)DEEPSEEK_API_KEY=your_deepseek_api_key| Category | Examples | Description |
|---|---|---|
| Economy | -balance, -work, -gamble | Manage virtual currency and jobs |
| Moderation | -warn, -ban, -mute | Keep your server organized |
| Music | -np, -lastfm | Share what you're listening to |
| Levels | -rank, -leveltop | Track your server progression |
| Utility | -info, -birthday | Helpful server tools |
For complete command documentation, visit docs.leurs.ch
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
 Milan Lead Developer |  Reazn Developer |  Seakyy Developer |  lhilfiker Contributor |  PianoNic Contributor |
This project is licensed under the MIT License - see the LICENSE file for details.
If Leurs has enhanced your Discord server experience, please consider:
- ⭐ Starring this repository to show your support
- 🐛 Reporting bugs to help us improve
- 💡 Suggesting features for future updates
- 🤝 Contributing code to make Leurs even better
- Documentation: docs.leurs.ch
- Issues: GitHub Issues
- Pull Requests: GitHub PRs
Made with ❤️ by the Leurs Team