Skip to content
thanosbotsPublic

About

Alice Music Bot 2.x by Rishabh Anand / Thanos Pro — a self-hosted Python Telegram music bot for group voice chats. No music API key required. Deploy on Railway, Linux VPS or macOS.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Alice music bot — lavender headphones monogram

Alice Music Bot — Telegram Music Bot Without a Music API Key

Official maintained repository for Alice 2.x by Rishabh Anand / Thanos Pro.

Documentation · Deployment guides · Previous Alice repository

Animated lavender and lime audio waveform

ALICE 2.0 · FREE TO USE · NO MUSIC API KEY NEEDED

Support ↗   /   Updates ↗   /   Developer ↓

Try Alice now

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

Free Deploy

Deploy Alice Music Bot on Railway

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.

What can Alice do?

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.


Documentation

Commands, deployment, configuration and troubleshooting are in the Alice documentation ↗.

For help, join the Telegram support group ↗.

Run your own Telegram music bot

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.sh

Setup 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.sh

Add 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.

Frequently asked questions

Does Alice work without an API?

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.

Is Alice free?

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.

Which credentials do I need?

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.

Where can I deploy Alice?

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.

    Railway deployment guide

  • Linux VPS — Host Alice on your own server with the complete installation and startup guide.

    Linux VPS deployment guide

  • Local Linux — Run Alice on your Linux computer. Keep the machine awake and connected.

    Local Linux deployment guide

  • macOS — Set up Alice on your Mac, with instructions for keeping it running.

    macOS deployment guide

Railway free/trial hosting depends on account eligibility and usage limits.

Developer

Rishabh Anand

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-developers

Chetan Anand

Co-developer · Alice Music Bot

Shreyas Lande

Co-developer · Alice Music Bot

Support & community

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.

Credits

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

About

Alice Music Bot 2.x by Rishabh Anand / Thanos Pro — a self-hosted Python Telegram music bot for group voice chats. No music API key required. Deploy on Railway, Linux VPS or macOS.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages