SplusPy v2.2.11
A fast, minimal, and fully-featured framework for Soroush Plus — self-bots and official bots
About
SplusPy is a Python library designed specifically for building Soroush Plus self-bots (userbots) and official bots. It provides a clean, intuitive API for automating your personal Soroush Plus account or building bots via the official HTTP Bot API.
⚠️ Note: This framework supports both self-bot (personal account) and official bot (Bot API) modes. Please adhere to Soroush's Terms of Service.
Installation
pip install SplusPy
To upgrade to the latest version:
pip install --upgrade Spluspy
Quick Start
Here is a minimal example to get your self-bot up and running:
import spluspy
from spluspy import events
client = spluspy.Client("my_session")
@client.on_message()
async def handler(client, event):
if event.message.message.lower() == "hello":
await event.reply("Hi there!")
client.start()
client.run_until_disconnected()
How it works
- Create a
Client— pass a session name (or path) to store your login. - Register handlers — use
@client.on_message()to react to messages. - Start the client — call
client.start()to connect and log in. - Run forever —
client.run_until_disconnected()keeps the bot alive.
Official Bot (Robot)
You can also build official bots using the HTTP Bot API:
from spluspy import Robot, filters
bot = Robot("YOUR_BOT_TOKEN")
@bot.on_message(filters.text("hello"))
async def hello_handler(client, event):
await event.reply("Hi there!")
bot.run()
How it works
- Create a
Robot— pass your bot token. - Register handlers — use
@bot.on_message()just like the self-bot. - Run — call
bot.run()to start long-polling.
License
MIT License. See LICENSE for details.
1 maintainer
Metadata
1 maintainer
Release files for spluspy 2.2.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| spluspy-2.2.11.tar.gz | 595.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| spluspy-2.2.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / spluspy-2.2.11.tar.gz
| Download URL | spluspy-2.2.11.tar.gz |
|---|---|
| Size | 595.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0aaa79cf67e22327a32dffe1594f1b6f5d57a0d70cc79b5386099ca365134189
|
|
BLAKE2b-256 checksum How to use checksums |
669e681b6460802d51a20251c612bc10955becd6e9e02adbf55c96c175ae452a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.4
|
Release files / spluspy-2.2.11-py3-none-any.whl
| Download URL | spluspy-2.2.11-py3-none-any.whl |
|---|---|
| Size | 731.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4ebb829acdf2b8bd7504c98000ab623c472b3fb5572d2bc6fcd6d3775d4e25fb
|
|
BLAKE2b-256 checksum How to use checksums |
c9c7c9d0e720847756ded15df51cea72a7fbce3bac28549a0f12ae7e1e6d6a01
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.4
|
