Pluggable Telegram UserBot
Inspiration  •  Features  •  Example  •  Requirements  •  Project Credits  •  Copyright & License

Userge

Userge is a Powerful , Pluggable Telegram UserBot written in Python using Pyrogram.

Inspiration

This project is inspired by the following projects :)

• tg_userbot ( heavily )
• PyroGramUserBot
• Telegram-Paperplane
• UniBorg

Special Thanks to all of you !!!.

Features

• Powerful and Very Useful built-in Plugins
  • gdrive ( Team Drives Supported! )
  • zip / unzip
  • telegram upload
  • telegram download
  • etc...
• Channel & Group log support
• Database support
• Build-in help support
• Easy to Setup & Use
• Easy to add / port Plugins
• Easy to write modules with the modified client

Example Plugin

from userge import userge, Message

LOG = userge.getLogger(__name__)  # logger object

CHANNEL = userge.getCLogger(__name__)  # channel logger object

@userge.on_cmd("test", about="help text to this command")  # adding handler and help text to .test command
async def testing(message: Message):
   LOG.info("starting test command...")  # log to console

   await message.edit("testing...", del_in=5)  # this will be automatically deleted after 5 sec

   await CHANNEL.log("testing completed!")  # log to channel

Requirements

• Python 3.6 or Higher
• Telegram API Keys
• Google Drive API Keys
• MongoDB Database URL

  • Step 1

    

  • Step 2

    

  • Step 3

    

  • Step 4

    

  • Step 5

    

  • Step 6

    

  • Step 7

    

  • Final Step

    

    REMEMBER the password

How To Deploy

• HEROKU Method.

  First click the button below.
  If you don't have HU_STRING_SESSION just ignore it.
  After Deployed to Heroku first turn off the app (resources -> turn off) and run bash genStr in console (more -> run console).
  After that copy the string session and past it in Config Vars (settings -> reveal config vars).
  Finally turn on the app and check the logs (settings -> view logs) :)

• Other Method.

  # clone the repo
  git clone https://github.com/UsergeTeam/Userge.git
  cd Userge
  
  # create virtualenv
  virtualenv -p /usr/bin/python3 venv
  . ./venv/bin/activate
  
  # install requirements
  pip install -r requirements.txt
  
  # Create config.env as given config.env.sample and fill that
  cp config.env.sample config.env
  
  # get string session and add it to config.env
  bash genStr
  
  # finally run the Userge ;)
  bash run

TODO: add Docker Support.

Support & Discussions

Head over to the Discussion Group and Update Channel

Project Credits

• Specially to these projects
• @uaudIth
• @K_E_N_W_A_Y
• @nawwasl
• @gotstc

Copyright & License

• Copyright (C) 2020 by UsergeTeam
• Licensed under the terms of the GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007