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 need | Where it comes from |
|---|---|
| Telegram bot token | Create your bot with BotFather ↗. |
| API ID & API hash | Create a Telegram application at my.telegram.org ↗. |
| Assistant session | Use a Telegram user account. Follow the assistant session guide. |
| MongoDB connection URI | Use a reachable MongoDB database with an application user. |
| A host for the bot | A 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
Invite Alice
Add your bot to the group. Give it permission to manage voice chats and invite the assistant.
Open the voice chat
Start a group voice chat. Make sure your assistant can join the group and speak in the call.
Pick a song
Send /play song name artist. Join the voice chat to listen with everyone else.
Make it your queue
Send another song request to add it to the queue. Use /search when you want to choose a result.