WeebProject Userbot

#include <std/disclaimer.h>
/*
   Your Telegram account may get banned.
   I am not responsible for any improper use of this bot
   This bot is intended for the purpose of having fun with memes,
   as well as efficiently managing groups.
   You ended up spamming groups, getting reported left and right,
   and you ended up in a Finale Battle with Telegram and at the end
   Telegram Team deleted your account?
   And after that, then you pointed your fingers at us
   for getting your acoount deleted?
   I will be rolling on the floor laughing at you.
*/

A modular Telegram Userbot running on Python3 with sqlalchemy database.

based on ProjectBish Userbot

Variable For Heroku Vars Settings

Click for more details

1. Required Variable name and value

APIKEY # Get this value from Telegram.org.

APIHASH # Get this value from Telegram.org.

BOTLOG # Set to False to disable group logging. (Default True)

BOTLOG_CHATID # Log chat id. Set it to 0 if BOTLOG = False and/or LOGSPAMMER = False.

HEROKUAPIKEY # Get your Heroku API from Heroku Account Settings.

HEROKUAPPNAME # Your Heroku app name which are deployed as userbot.

LOGSPAMMER # Set this to True in case you want the error logs to be stored in the userbot log group. (requires a valid BOTLOG_CHATID to be set).

STRINGSESSION # Get this value by running [python3 stringsession.py] in Termux or local system.

TMPDOWNLOADDIRECTORY # This variable for Download directory for many modules (GDrive, .download etc..).

2. Non Mandatory Variable Name. [Recommended to fill this]
ALIVE_NAME # Name to show in .alive message.

ALIVE_LOGO # Show Image/Logo in .alive message. Use telegra.ph or any direct link image.

ANTI_SPAMBOT # Kick spambots from groups after they join. (Requires admin permissions in group) fill this with True or False

ANTISPAMBOTSHOUT # Fill this value as false. if you're want Report spambots to @admins in groups after they join, just in case when you don't have admin powers to kick that shit by yourself.

BIO_PREFIX # Prefix for Last.FM Module Bio.

COUNTRY # Your Country to be used in the .time and .date commands.

CLEAN_WELCOME # When a new person joins, the old welcome message is deleted, Set this to True or False.

CONSOLELOGGERVERBOSE # If you need verbosity on the console logging, set this True or False.

DEEZERARLTOKEN # Your DEEZER ARL TOKEN. If you don't know this, leave it blank.

DEFAULT_BIO # Default you profile bio.

GDRIVEDATA # Your client_secret.json.

GDRIVEINDEX_URL # Your Cloudflare Google Drive Index URL.

GENIUSACCESSTOKEN # Client Access Token from Genius site.

LASTFMAPI # API Key for Last.FM module. Get one from Last.FM site, Leave this blank if you won't use last.fm module.

LASTFMSECRET # SECRET Key for Last.FM module. Get one from Last.FM site, Leave this blank if you won't use last.fm module.

LASTFM_PASSWORD # Your last.fm password. Leave this blank if you won't use last.fm module.

OPENWEATHERMAPAPPID # Get your own API key from Open Weather Map site. Leave it blank if you won't use this.

OCRSPACEAPIKEY # OCR API Key for .ocr command. Get one from OCR Space site.

PMAUTOBAN # PM shield if you won't any user spam your PM. Set this True or False.

REMBGAPIKEY # API Key for .rbg command. Get one from remove.bg.

TZ_NUMBER # Fill 1 as a default value, Or in your country has multiple time zones. Just change the value to any time zones.

TERM_ALIAS # Display user for .term command.

UPSTREAMREPOURL # In case you're maintaining a fork repo, fill this with your fork repo url. if not, just leave this blank.

USRTOKENUPTOBOX # Uptobox API for uptobox direct link. Read this (Required premium uptobox account).

WEATHER_DEFCITY # Set the default city for the userbot's weather module.

Deploy
Heroku (GitHub Actions)
Create github account and heroku account

Fork this repository [RECOMMEND TO ENABLE DEKSTOP MODE IN YOUR BROWSER]

Go to Your GitHub Forked repository settings. [[example pict]](https://telegra.ph/file/5f8e378f13f41ff7971de.jpg), Scroll down then Click Secret > actions

Fill All credentials required in Github secrets

HEROKUAPI. Fill your Heroku api key

HEROKU_APP. Fill your Heroku app name. This name should only contain lowercase letters, numbers, and dashes.

HEROKU_REGION. Fill us or en

HEROKU_EMAIL. Your heroku email

Now Go To Action tab in your repository [[example pict]](https://telegra.ph/file/28cecfc199fc34558ac91.jpg), Click Select Workflow [[example pict]](https://telegra.ph/file/5efd02314c3689bf149f3.jpg) Choose Heroku Container build and push Then Click Run Workflow from master branch [[example pict]](https://telegra.ph/file/b0afed12ff49f0ddf7c58.jpg). Wait process finish, if you got some errors while run workflow You can ask in SUPPORT GROUP

After deploy is finished, go to your heroku resource app add heroku posgress, check pict below

Heroku posgress

Using "Bare hands", using Git and Python3 -- on (Linux, macOS, and Android [via Termux])
Clone this repository on your local machine and cd (or chdir, anti bloat guy) to it

Set up Python virtual environment named "venv" inside it (Requires virtualenv installed on the system)

- virtualenv venv - Don't forget to activate the virtualenv: . venv/bin/activate
Set up database for the userbot, search Google on how to set up a local database (PostgreSQL is recommended)

Install the requirements: pip3 install -r ./requirements.txt

Edit sample_config.env and save it as config.env

- Do not forget to fill in the REQUIRED %% values, or else the bot will not run
Run the bot: bash ./exec.sh

- Protip: See what bash ./exec.sh --help tells you

Docker
Clone this repository on your local machine and cd (or chdir, anti bloat guy) to it

Edit sample_config.env and save it as config.env

- Set DATABASE_URL to postgresql://USERNAME:PASSWORD@db:5432/weebproject - You should set USERNAME and PASSWORD too in docker-compose.yml - Do not forget to fill in the REQUIRED %% values, or else the bot will not run
Run docker: docker-compose up

※ Those steps are probably possible to pull off on Windows but it's pretty much unknown (different file tree paradigm, directory conventions, PowerShell instead of BASH or ZSH) -- If you're on Windows, you'd be better off running this on WSL (or WSL2)

Credits

Adek Maulana - ProjectBish

Mr. Miss - UserButt

Move Angel - One4uBot

Aidil Aryanto - ProjectDils

Alfianandaa - ProjectAlf

GengKapak - DCLXVI

and everyone that makes this userbot awesome :D

License
Licensed under Raphielscape Public License - Version 1.d, February 2020

🔗 More in this category

public-apis/public-apis

A collective list of free APIs

★ 447.8k

EbookFoundation/free-programming-books

:books: Freely available programming books

★ 391.5k

vinta/awesome-python

An opinionated list of Python frameworks, libraries, tools, and resources

★ 307.0k

tensorflow/tensorflow

An Open Source Machine Learning Framework for Everyone

★ 196.3k

donnemartin/system-design-primer

Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

★ 356.6k

TheAlgorithms/Python

All Algorithms implemented in Python

★ 222.5k

NousResearch/hermes-agent

The agent that grows with you

★ 212.6k

Significant-Gravitas/AutoGPT

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.

★ 185.4k

huggingface/transformers

🤗 Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models, for both inference and training.

★ 162.4k

yt-dlp/yt-dlp

A feature-rich command-line audio/video downloader

★ 176.2k

langgenius/dify

Production-ready platform for agentic workflow development.

★ 148.4k

anthropics/skills

Public repository for Agent Skills

★ 159.3k

© 2026 GitRepoTrend · BianSepang/WeebProject · Updated daily from GitHub