Home

Stelle is an open-source alternative to music bots, using seyfert as the heart.
So, in this wiki, we will try to teach you how to run the bot.

TL;DR: Don't try to skip anything, it won't work buddy.

Stelle uses lavalink to play audio and hoshimi as the client to interact with lavalink.

⚙️ Prerequisites

• PNPM v10.7.0+ (the repo pins pnpm@11)
• NodeJS v22.11.0+
• MongoDB Database (you can create a free* cluster)
• Redis (you can create a free* server)
• A Lavalink node (self-hosted or public)
• Visual Studio Code (optional, but recommended)

Important

If you are trying to run the bot, PLEASE make sure you follow the Installation section.

Note

The dev branch is where the latest (and sometimes experimental) features live. This wiki tracks it.

📜 Table of Contents

Getting started

• 📦 Installation
• 🐳 Docker
• 📦 Environment Variables
• 📦 Configuration
• 📦 Lavalink node

Using Stelle

• 📦 Features
• 📦 Commands

Advanced

• 📦 Development
• 📦 Workers

Reference

• 📦 Frequently Asked Questions
• 📦 Changelogs

🧩 The stack

Piece	What it does
seyfert	The framework Stelle is built on (handlers, commands, cache).
hoshimi	The Lavalink client that talks to the audio node(s).
Prisma + MongoDB	ORM and database (playlists, prefixes, locales, player settings).
Redis	Queue store and secondary cache.
TypeScript + tsx	Language and the runtime used for pnpm dev.
Biome	Linter and formatter.