Deploy with AstrBot Desktop Client
AstrBot-desktop is designed for quick local deployment of AstrBot on your personal computer, supporting Windows, macOS, and Linux.
Among the various deployment options, the desktop client is best suited for personal local use. It is not recommended for long-term server operation or production environments. For production deployments, consider Docker or Kubernetes instead.
Compared to command-line or container-based solutions, the desktop client offers an out-of-the-box experience, ideal for users who want to get started without dealing with environment setup.
Repository: AstrBotDevs/AstrBot-desktop
Who Is It For
- Users who want quick local deployment with a graphical interface.
- Beginners who don't want to manually manage Docker / Python environments.
- Personal devices that stay online, primarily for individual or small team daily use.
Key Features
- Multi-platform installers, ready to use after download.
- GUI-based configuration, lowering the barrier for first-time deployment.
- Suitable as a locally resident client.
Download and Install
- Open AstrBot-desktop Releases.
- Download the installer for your operating system (e.g.
.exe,.dmg,.rpm,.deb). - Launch the desktop client after installation and follow the setup wizard to complete initialization.
Check for Updates
The desktop client automatically checks for app updates when the main interface loads. When an update is available, the header displays “AstrBot has a new version!” in both Bot and Chat modes. A dot also appears on the options menu in the top-right corner, and the update entry inside the menu is marked.
Click “AstrBot has a new version!” in the header to open the desktop app update dialog. You can also open the options menu and select the update entry to check manually and confirm installation. Automatic checks do not download or install updates. If a check fails, use the same entry to retry.
Difference from Launcher Deployment
- Desktop client: focuses on an out-of-the-box GUI experience.
- Launcher deployment: focuses on automated script-based startup, suitable for users who prefer a traditional deployment workflow.
- See Launcher Deployment.