alice.The music bot
field guide
The voice in the room

Meet the assistant.

Alice’s assistant is a Telegram user account that joins your group call and plays the audio.

Two accounts, two jobs

SettingAccountJob
BOT_TOKENTelegram botReceives commands and sends player cards.
STRING_SESSIONTelegram userJoins voice chats and streams audio.

Use a Pyrogram/Pyrofork-compatible string session. The session format used by CipherElite is separate.

Use our Telegram session maker

Open Elite Session Maker ↗

  1. Open @elite_session_maker_bot and press Start.
  2. Choose Pyrogram v2.
  3. Follow the bot’s prompts for your assistant Telegram account.
  4. Copy the generated string into STRING_SESSION in Config.env.

The bot offers Elite, Pyrogram and Telethon sessions. Select Pyrogram v2 for Alice.

Optional: generate locally or find your user ID

Run bash setup.sh first. Then run the following from the Alice project directory on a trusted computer. Enter the API ID and hash for your own Telegram application.

Terminal
.venv/bin/python -c 'from pyrogram import Client; from getpass import getpass; api_id = int(input("API ID: ")); api_hash = getpass("API hash: "); app = Client("alice-session", api_id=api_id, api_hash=api_hash, in_memory=True); app.start(); print("User ID:", app.get_me().id); print(app.export_session_string()); app.stop()'

Follow Telegram’s login prompts for your phone number, login code and two-step verification password if enabled. Copy the exported string into STRING_SESSION in Config.env.

The local helper also prints the numeric ID of the account you log in with. Use your owner account’s ID for OWNER_ID. If the owner and assistant are different accounts, keep the assistant’s session in STRING_SESSION.

Let the assistant join

Add the assistant to your music group, or let the bot invite it using the necessary permissions. Start a voice chat and allow the assistant to speak. Keep one running Alice instance per assistant session.

If access needs to be reset

Stop Alice, revoke the relevant session in Telegram’s Devices settings, and generate a fresh Pyrogram session. Replace STRING_SESSION and restart the bot.

KEEP GOINGStart Alice on your host
Search the field guide · ↓ to select · Enter to open · Esc to close