✨ | MXUserbot | ✨

😉 | The bot is in active development, so don't judge too harshly :)

What is a userbot: A bot that runs directly on your account, acting on your behalf.
Purpose: From showing off to your friends that you use bot commands from your account to automation and useful modules. It all depends on you!

Matrix Space

We have Matrix space: #SpacePashaHatsune:matrix.org

---

✨ | Feature

Emoji Callbacks - Reactions as buttons.

FSM - Multi-step dialogs with state persistence.

Web Panel - Manage modules/account via web panel

SUDO LIST - Grant your friend permission to execute commands

SAS Verification - Verify your device anywhere!.

Module Repository — add custom repositories!

Rate Limiter - AIMD-based protection against "Too Many Requests" allows you to run your userbot on any server!.

Login via SSO

Login via @user:server

Installation

Docker

git clone https://github.com/PashaHatsune/MxUserbot.git
cd MxUserbot
docker-compose up --build

Manual Installation on uv

git clone https://github.com/PashaHatsune/MxUserbot.git
cd MxUserbot
uv sync
uv run -m src.mxuserbot

---

Systemd (User Service)

To run the userbot in the background as a system daemon

mkdir -p ~/.config/systemd/user/
cp mxuserbot.service ~/.config/systemd/user/
# Edit WorkingDirectory in the service file if needed
systemctl --user daemon-reload
systemctl --user enable --now mxuserbot.service

---

Documentation

https://mxuserbot.github.io/documentation/

---

Donate

https://destream.net/live/Pashahatsune/donate

---

Contribution

We accept Issues and Pull requests.
If you have ideas or code — send them over, I will review everything.

---

Disclaimer

This software is provided "as is", without warranty of any kind, express or implied. By using this userbot, you acknowledge that:

• Full Responsibility: You are solely responsible for your actions and any consequences resulting from the use of this software.
• No Liability: The developer shall not be held liable for any damages, including but not limited to account bans, data loss, or legal issues.
• Strict Prohibition: Use of this bot for fraudulent activities, spam, or any actions that violate terms of service or local laws is strictly prohibited.

---

Credits

• @ArThirtyFour — thanks for help with the code/banner.
• @maseckt — thanks for help with the code/videos.

---