alice.The music bot
field guide
Start here

Your first song.

A bot, an assistant, and a group of friends. Here’s how to bring them together.

Meet your listening room

Alice plays audio in Telegram group voice chats. The bot handles messages and controls; a separate Telegram user account, the assistant, joins the call and streams the music.

Search by song or artist, use a supported song link, or reply to a Telegram audio file or voice message.

A few things to collect

You needWhere it comes from
Telegram bot tokenCreate your bot with BotFather ↗.
API ID & API hashCreate a Telegram application at my.telegram.org ↗.
Assistant sessionUse a Telegram user account. Follow the assistant session guide.
MongoDB connection URIUse a reachable MongoDB database with an application user.
A host for the botA Linux VPS or an always-on machine with Python 3, venv support and FFmpeg.

Set up Alice

Follow the bot deployment guide to install dependencies, then fill in Config.env using the configuration reference.

Choose the complete VPS guide, Local Linux guide or macOS guide. Each includes installation, nano configuration and tmux startup.

Press play

01

Invite Alice

Add your bot to the group. Give it permission to manage voice chats and invite the assistant.

02

Open the voice chat

Start a group voice chat. Make sure your assistant can join the group and speak in the call.

03

Pick a song

Send /play song name artist. Join the voice chat to listen with everyone else.

04

Make it your queue

Send another song request to add it to the queue. Use /search when you want to choose a result.

KEEP GOINGFind your next command
Search the field guide · ↓ to select · Enter to open · Esc to close