Official maintained repository for Alice 2.x by Rishabh Anand / Thanos Pro.
Documentation · Deployment guides · Previous Alice repository
ALICE 2.0 · FREE TO USE · NO MUSIC API KEY NEEDED
Support ↗ /
Updates ↗ /
Developer ↓
Already hosted. Ready for your group.
Use our deployed bot @alice2music_bot on Telegram—no server setup or personal API credentials needed to try it.
Open Alice on Telegram ↗ · Add Alice to your group ↗
Open the bot and tap Start, then add it to your group and follow its setup instructions. Once the group voice chat and required permissions are ready, use /play song name to start listening. Want your own instance? Follow the deployment guide below.
Your group. Your music. No paid music API.
Alice 2.0 is a free, self-hosted Telegram music bot for group voice chats. Search for songs, share supported music links, or play Telegram audio with queue controls and custom player cards. Built in Python with Pyrofork and Py-TgCalls, Alice handles music lookup inside the bot—there is no separate music API server to deploy or music API key to buy.
100% free to use. No music API key needed.
Alice charges no bot subscription or music API fee. Hosting, internet and database costs depend on your setup. Telegram credentials are required only when hosting your own instance.
Current code release: 2.1.6, part of the Alice 2.x series.
Get started · Deploy Alice · Command guide
Deploy Alice Music Bot with ready-made variable fields and persistent session storage. Add your credentials and deploy.
Railway free/trial usage is subject to account eligibility and usage limits; continuous hosting may require a paid plan.
Song search and playback from supported song links.
Telegram audio files and voice messages.
Queue management, shuffle, repeat and admin playback controls.
Song artwork and player cards with a charcoal and gold design.
Private owner tools for statistics, broadcasts and database management.
Commands, deployment, configuration and troubleshooting are in the Alice documentation ↗.
For help, join the Telegram support group ↗.
You need Python 3, FFmpeg/FFprobe, a MongoDB connection, a Telegram bot token, and Telegram API credentials with an assistant account session. The setup script prepares the Python 3.11 environment and installs the bot dependencies.
git clone https://github.com/thanosbots/Alice.git
cd Alice
bash setup.shSetup automatically installs Alice’s built-in music URL resolver. No Docker container, local API port, music API key or separate service needs to be configured. start.sh also runs setup if the resolver dependency is missing. Music availability still depends on the provider.
Fill in the generated Config.env using Config.env.example, then start Alice:
bash start.shAdd the bot and assistant account to your group, grant the permissions described in the getting started guide, and open a voice chat.
| Command | What it does |
|---|---|
/play song name |
Find a song and play it or add it to the queue |
/search song name |
Choose from matching songs |
/queue |
View upcoming tracks |
/pause, /resume |
Control playback |
/skip, /stop |
Move to the next track or end playback |
/shuffle, /repeat |
Change how the queue plays |
You can also reply to a Telegram audio file or voice message with /play. Playback and queue edits are restricted to group admins or the configured bot owner.
Song-name searches compare up to 30 results using title, artist/movie matches and popularity instead of blindly playing the first result. For example, /play dilbar dilbar prefers the popular Satyameva Jayate recording; /play dilbar alka yagnik requests the older version. Add an artist, film or year for a particular recording, or use /search to choose. Unrequested remixes and lofi versions are deprioritized. This is a best-match heuristic, not a guarantee that every ambiguous title selects the version you intended; compilation release years alone do not identify a newer recording.
No music API key is needed. Alice does not need a paid music API subscription or a separately hosted music API server. It still makes online requests to a music provider and uses Telegram's API, so it is not API-free or offline.
Alice is free to use, with no bot subscription or music API fee. Your hosting provider, database provider or internet service may charge for their services.
Your Telegram API_ID, API_HASH, BOT_TOKEN, assistant STRING_SESSION, and MongoDB MONGO_URL. Keep these in your local Config.env; never commit them to GitHub.
Choose your platform for a step-by-step deployment guide.
-
Railway — Deploy with the Alice template. Fill in your values and let Railway handle the setup.
-
Linux VPS — Host Alice on your own server with the complete installation and startup guide.
-
Local Linux — Run Alice on your Linux computer. Keep the machine awake and connected.
-
macOS — Set up Alice on your Mac, with instructions for keeping it running.
Railway free/trial hosting depends on account eligibility and usage limits.
Creator & Lead Developer · Founder of Thanos Pro
I build Telegram bots and automation tools in Python. Alice and CipherElite ↗ are my projects under Thanos Pro.
GitHub ↗
/
Telegram ↗
/
Instagram ↗
/
LinkedIn ↗
@rishabhops on GitHub · @thanosceo on Telegram · @xrishabhanand on Instagram & LinkedIn
Co-developer · Alice Music Bot
- Telegram: @Xketan
- Instagram: @xchetan45
- GitHub: chetananand28
- LinkedIn: Chetan Anand
Co-developer · Alice Music Bot
- Instagram: @_shrey999
- GitHub: shreyaslande
- LinkedIn: Shreyas Lande
Talk to us. Stay in the loop.
Join the conversation ↗
Questions, bug reports and feedback — our Telegram support group.
Follow Thanos Pro ↗
Project news and release updates.
Message me ↗
Get in touch directly on Telegram.
If you enjoy using Alice, leave a star on the repository or share it with your friends. Bug reports and contributions are welcome too.
Thanks to the projects that make Alice possible:
Telegram & voice
Pyrofork ↗ · Py-TgCalls ↗ · NTgCalls ↗
Audio, storage & artwork
FFmpeg ↗ · MongoDB ↗ · Pillow ↗
Alice Music Bot · Thanos Pro
Rishabh Anand · Chetan Anand · Shreyas Lande