{"id":13611682,"url":"https://github.com/code-rgb/USERGE-X","last_synced_at":"2025-04-13T05:33:17.592Z","repository":{"id":45519334,"uuid":"286453342","full_name":"code-rgb/USERGE-X","owner":"code-rgb","description":"USERGE-X. What the X ?","archived":true,"fork":false,"pushed_at":"2021-05-14T08:52:22.000Z","size":6200,"stargazers_count":128,"open_issues_count":2,"forks_count":465,"subscribers_count":7,"default_branch":"alpha","last_synced_at":"2024-11-07T18:48:03.408Z","etag":null,"topics":["bot","heroku","inline","pyrogram","python3","telegram","userbot"],"latest_commit_sha":null,"homepage":"https://del.dog/userge-x","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/code-rgb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-10T11:13:24.000Z","updated_at":"2024-10-28T22:58:32.000Z","dependencies_parsed_at":"2022-09-13T02:22:48.374Z","dependency_job_id":null,"html_url":"https://github.com/code-rgb/USERGE-X","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-rgb%2FUSERGE-X","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-rgb%2FUSERGE-X/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-rgb%2FUSERGE-X/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-rgb%2FUSERGE-X/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code-rgb","download_url":"https://codeload.github.com/code-rgb/USERGE-X/tar.gz/refs/heads/alpha","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248670513,"owners_count":21142896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","heroku","inline","pyrogram","python3","telegram","userbot"],"created_at":"2024-08-01T19:02:00.212Z","updated_at":"2025-04-13T05:33:12.601Z","avatar_url":"https://github.com/code-rgb.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003e\u003cb\u003eOwner: \u003ca href=\"https://telegram.dog/deleteduser420\"\u003e𝚂𝚢𝚗𝚝𝚊𝚡 ░ Σrr♢r\u003c/a\u003e\u003c/b\u003e\u003c/h2\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n   \u003ca href=\"https://github.com/code-rgb/USERGE-X\"\u003e\u003cimg src=\"https://i.imgur.com/53mdl2v.png\" alt=\"Userge-x\" width=400px\u003e\u003c/a\u003e\n   \u003cbr\u003e\n   \u003cbr\u003e\n\u003c/p\u003e\n\u003ch1\u003eUSERGE-X\u003c/h1\u003e\n\u003cb\u003ePluggable Telegram UserBot\u003c/b\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n[![Open Source Love svg1](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://github.com/code-rgb/userge-x)\n[![GPLv3 license](https://img.shields.io/badge/License-GPLv3-blue.svg?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X#copyright--license)\n[![Stars](https://img.shields.io/github/stars/code-rgb/USERGE-X?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X/stargazers)\n[![Forks](https://img.shields.io/github/forks/code-rgb/USERGE-X?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X/network/members)\n[![Issues Open](https://img.shields.io/github/issues/code-rgb/USERGE-X?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X/issues)\n[![Issues Closed](https://img.shields.io/github/issues-closed/code-rgb/USERGE-X?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X/issues?q=is:closed)\n[![PR Open](https://img.shields.io/github/issues-pr/code-rgb/USERGE-X?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X/pulls)\n[![PR Closed](https://img.shields.io/github/issues-pr-closed/code-rgb/USERGE-X?\u0026style=flat-square)](https://github.com/code-rgb/USERGE-X/pulls?q=is:closed)\n![Repo Size](https://img.shields.io/github/repo-size/code-rgb/userge-x?style=flat-square)\n[![CodeFactor](https://www.codefactor.io/repository/github/code-rgb/userge-x/badge?\u0026style=flat-square)](https://www.codefactor.io/repository/github/code-rgb/userge-x)\n[![DeepSource](https://deepsource.io/gh/code-rgb/userge-x.svg/?label=active+issues\u0026show_trend=true)](https://deepsource.io/gh/code-rgb/userge-x/?ref=repository-badge)\n[![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod\u0026style=flat-square)](https://gitpod.io/#https://github.com/code-rgb/userge-x)\n[![Docker Image](https://img.shields.io/docker/image-size/varietyjames1/userge_x?color=blue\u0026label=Docker%20Size\u0026style=flat-square\u0026logo=docker\u0026logoColor=white)](https://hub.docker.com/r/varietyjames1/userge_x/tags?page=1\u0026ordering=last_updated)\n\u003cbr\u003e\n\n**USERGE-X** is a Powerful , _Pluggable_ Telegram UserBot written in _Python_ using [Pyrogram](https://github.com/pyrogram/pyrogram).\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://telegram.dog/x_xtests\"\u003e\u003cimg src=\"https://img.shields.io/badge/Support%20Group-USERGE--%F0%9D%91%BF-blue?\u0026logo=telegram\u0026style=social\" width=220px\u003e\u003c/a\u003e\u003c/p\u003e\n\n## Disclaimer\n```\n/**\n   ⚠️Kang at your own risk⚠️          \n   Your Telegram account may get banned.\n   I am not responsible for any improper use of this bot\n   This bot is intended for the purpose of having fun with memes,\n   as well as efficiently managing groups.\n   It can help you with managing yourself as well.\n   You ended up spamming groups, getting reported left and right,\n   and then you ended up in a Final Battle with Telegram\n   and at the end the Telegram Team\n   deleted your account?\n   And after that, you pointed your fingers at us\n   for getting your account deleted?\n   We will be rolling on the floor laughing at you.\n   Yes! you heard it right.\n/**\n```\n## Requirements \n* Python 3.8 or Higher\n* Telegram [API Keys](https://my.telegram.org/apps)\n* Google Drive [API Keys](https://console.developers.google.com/)\n* MongoDB [Database URL](https://cloud.mongodb.com/)\n## How To Deploy \n* With Heroku:\n\u003cp align=\"center\"\u003e\n   \u003ca href = \"https://heroku.com/deploy?template=https://github.com/code-pms/MyGpack\"\u003e\u003cimg src=\"https://telegra.ph/file/57c4edb389224c9cf9996.png\" alt=\"Press to Takeoff\" width=\"490px\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n\u003e **NOTE** : your can fill other vars as your need and they are optional. (settings -\u003e reveal config vars)\n* First click The Button Above.\n* Fill `API_ID`, `API_HASH`, `DATABASE_URL`, `LOG_CHANNEL_ID`, `HEROKU_APP_NAME` and `HEROKU_API_KEY` (**required**)\n* Then fill Dual Mode vars : `OWNER_ID`, `BOT_TOKEN` and `HU_STRING_SESSION`\n* Then fill [other **non-required** vars](https://telegra.ph/Heroku-Vars-for-USERGE-X-08-25) later\n* Finally **hit deploy** button\n## String Session\n**VAR -\u003e** `HU_STRING_SESSION`\n#### By HEROKU\n- [open your app](https://dashboard.heroku.com/apps/) then go to **more** -\u003e **run console** and type `bash genStr` and click **run**.\n#### On REPL\n- [Generate on REPL](https://repl.it/@Leorio/stringsessiongen#main.py)\n### Read more\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eDetails and Guides\u003c/b\u003e\u003c/summary\u003e\n\n## Other Ways\n\n* With Docker 🐳 \n    \u003ca href=\"https://github.com/code-rgb/USERGE-X/blob/alpha/resources/readmeDocker.md\"\u003e\u003cb\u003eSee Detailed Guide\u003c/b\u003e\u003c/a\u003e\n\n* With Git, Python and pip 🔧\n  ```bash\n  # clone the repo\n  git clone https://github.com/code-rgb/userge-x.git\n  cd userge-x\n\n  # create virtualenv\n  virtualenv -p /usr/bin/python3 venv\n  . ./venv/bin/activate\n\n  # install requirements\n  pip install -r requirements.txt\n\n  # Create config.env as given config.env.sample and fill that\n  cp config.env.sample config.env\n\n  # get string session and add it to config.env\n  bash genStr\n\n  # finally run the USERGE-X ;)\n  bash run\n  ```\n\n\n\u003ch2\u003eGuide to Upstream Forked Repo\u003c/h2\u003e\n\u003ca href=\"https://telegra.ph/Upstream-Userge-Forked-Repo-Guide-07-04\"\u003e\u003cb\u003eUpstream Forked Repo\u003c/b\u003e\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003ch3 align=\"center\"\u003eYoutube Tutorial\u003ch3\u003e\n\u003cp align=\"center\"\u003e\u003ca href=\"https://youtu.be/M4T_BJvFqkc\"\u003e\u003cimg src=\"https://i.imgur.com/VVgSk2m.png\" width=250px\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n## Features \n\n* Powerful and Very Useful **built-in** Plugins\n  * gdrive [ upload / download / etc ] ( Team Drives Supported! ) \n  * zip / tar / unzip / untar / unrar\n  * telegram upload / download\n  * pmpermit / afk\n  * notes / filters\n  * split / combine\n  * gadmin\n  * plugin manager\n  * ...and more\n* Channel \u0026 Group log support\n* Database support\n* Build-in help support\n* Easy to Setup \u0026 Use\n* Easy to add / port Plugins\n* Easy to write modules with the modified client\n\n## Example Plugin \n\n```python\nfrom userge import userge, Message, filters\n\nLOG = userge.getLogger(__name__)  # logger object\nCHANNEL = userge.getCLogger(__name__)  # channel logger object\n\n# add command handler\n@userge.on_cmd(\"test\", about=\"help text to this command\")\nasync def test_cmd(message: Message):\n   LOG.info(\"starting test command...\")  # log to console\n   # some other stuff\n   await message.edit(\"testing...\", del_in=5)  # this will be automatically deleted after 5 sec\n   # some other stuff\n   await CHANNEL.log(\"testing completed!\")  # log to channel\n\n# add filters handler\n@userge.on_filters(filters.me \u0026 filters.private)  # filter my private messages\nasync def test_filter(message: Message):\n   LOG.info(\"starting filter command...\")\n   # some other stuff\n   await message.reply(f\"you typed - {message.text}\", del_in=5)\n   # some other stuff\n   await CHANNEL.log(\"filter executed!\")\n```\n\n\u003c/details\u003e \n\n### Project Credits \n* [Pyrogram Assistant](https://github.com/pyrogram/assistant)\n* [PyroGramBot](https://github.com/SpEcHiDe/PyroGramBot)\n* [PaperPlane](https://github.com/RaphielGang/Telegram-Paperplane)\n* [Uniborg](https://github.com/SpEcHiDe/UniBorg)\n### Copyright \u0026 License \n[**GNU General Public License v3.0**](https://github.com/code-rgb/USERGE-X/blob/alpha/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-rgb%2FUSERGE-X","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-rgb%2FUSERGE-X","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-rgb%2FUSERGE-X/lists"}