alice.The music bot
field guide
From zero to first song

Pick Alice’s new home.

Four deployment options. Use the Railway screenshot walkthrough, or follow the VPS, Local Linux and macOS installation guides.

Which guide should I follow?

For an always-on bot: choose a VPS that stays powered on and connected. For your own computer: choose Local Linux or macOS and keep the machine awake while Alice is running.

Local Linux means Ubuntu or Debian. These commands are not native Windows PowerShell commands.

What you’ll set up

Railway handles dependencies and startup through its template. The following manual setup applies to VPS, Local Linux and macOS.

  1. System packages: Python, Git, FFmpeg/FFprobe, tmux and nano.
  2. The Alice bot source and its project-local Python environment.
  3. A Telegram bot token, API ID/hash and assistant user session.
  4. A MongoDB database connection.
  5. Config.env, edited and saved with nano.
  6. A named tmux session to run and manage Alice.

Hosting just this website?

This section sets up the Telegram music bot. For the documentation website, follow Host this website.

Search the field guide · ↓ to select · Enter to open · Esc to close