tgbot ๐Ÿ‘ป

March 1, 2026 ยท View on GitHub

This Telegram bot is built using the python-telegram-bot library version 21.9 and performs various tasks within Telegram.

This bot can be found as Ciri on Telegram.

If you liked this project then please give it a โญ | Thank You!

Features ๐Ÿณ

๐Ÿ“ Note (14/12/2024): Certain features have been temporarily removed due to limitations. They may be reintroduced in future updates. Additionally, not all features are listed here. We encourage you to start the bot and explore its full functionality. I appreciate your understanding.

  • Group Management โšก
    • It has just everything... ๐Ÿ˜‰
    • Whisper Message (secretly message a user in Group) ๐Ÿคซ
  • AI ๐Ÿค–
    • ChatGPT
    • AI Imagine
  • Misc โœจ
    • Get Movie Information
    • Built-in Language Translator
    • Decode, Encode (base64)
    • Short URL / Ping URL
    • Generate QR Code (Image)
    • Host Image Publicly (Link)
    • Pastebin (telegraph)
    • Convert text into speech (voice)
    • Built-in PSNDL Support
    • Get Any Location Weather Information
    • Calculate basic math
    • Take webshot (website screenshot) Removed due to limitations
    • Download YouTube video Removed due to limitations
      • Added YouTube audio/song download (14/01/2025)
    • Search YouTube video Removed due to limitations
    • Much more...๐Ÿคฉ Start Now to explore ๐ŸŒด

How to add new command?

  • Only for CommandHandler
  • Create your handler file/func inside bot/handlers
  • Add your handler details in bot/handler/commands.json
{
    "command": str or [str, str],   # str or list of str example: "start" or ["start", "demo"]
    "function": "",                 # func name example: func_start
    "module": ""                    # str example: .handlers.core.start
}

Deploy your own bot ๐Ÿ‘ฉโ€๐Ÿš€

Steps

  • Preparation ๐Ÿ“ฆ
  • Host ๐Ÿš€

Preparation ๐Ÿ“ฆ

  • Recommended python version 3.11

  • Download & Rename sample_config.env to config.env then fillup config.env file value's

    โš ๏ธ Note: Don't share or upload the config.env any public place or repository

config.env Values

  • BOT_TOKEN Get from https://t.me/BotFather E.g. 123456:abcdefGHIJK...
  • OWNER_ID Get from bot by /id command E.g. 2134776547
  • MONGODB_URI Get from https://www.mongodb.com/ (Check Below for instruction)
  • DB_NAME anything E.g. MissCiri_db

Creating MongoDB URI

Note (MongoDB): On the left side list click on Network Access section click on ADD IP ADDRESS and set ip to 0.0.0.0/0 (Its important to access database without network restriction)

Host ๐Ÿš€

Local Hosting ๐Ÿ’ป

  • Windows/Linux
    • Required python 3.11 (also tested on 3.13)
    • Open tgbot directory on cmd/shell
    • Run on cmd/shell pip install -r requirements.txt
    • Finally python -m bot

Render Deploy โšก

  • Signin/Signup on Render

  • Goto dashboard & create a New Web Service

  • Select Public Git Repository: https://github.com/bishalqx980/tgbot

  • Then ๐Ÿ‘‡

    > Language: Docker
> Branch: main
> Instance Type: Free [or paid]

  • Advanced option ๐Ÿ‘‡

    Secret Files

> Filename: 'config.env'
> File Contents: Paste all content from 'sample_config.env' (make sure you filled up everything)

    Note (Render Hosting): If you face anyproblem accessing Advanced option then just click on Create Web Service then from Environment > Secret Files and add the config.env values. Then restart/redeploy the web service.

    Important (Render Hosting): After deployment complete go to Render Dashboard and open your service then you can see service url on top left corner https://example.onrender.com copy that and go to bot /bsettings server url and edit with your service url. (So that bot won't go to sleep)

After deployment complete, don't forget to visit /bsettings

"Buy Me A Coffee"

๐“ ๐“น๐“ป๐“ธ๐“ณ๐“ฎ๐“ฌ๐“ฝ ๐“ธ๐“ฏ

 โ–„โ–„โ–„โ–„    โ–ˆโ–ˆโ–“  โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ  โ–ˆโ–ˆโ–‘ โ–ˆโ–ˆ  โ–„โ–„โ–„       โ–ˆโ–ˆโ–“    
โ–“โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–„ โ–“โ–ˆโ–ˆโ–’โ–’โ–ˆโ–ˆ    โ–’ โ–“โ–ˆโ–ˆโ–‘ โ–ˆโ–ˆโ–’โ–’โ–ˆโ–ˆโ–ˆโ–ˆโ–„    โ–“โ–ˆโ–ˆโ–’    
โ–’โ–ˆโ–ˆโ–’ โ–„โ–ˆโ–ˆโ–’โ–ˆโ–ˆโ–’โ–‘ โ–“โ–ˆโ–ˆโ–„   โ–’โ–ˆโ–ˆโ–€โ–€โ–ˆโ–ˆโ–‘โ–’โ–ˆโ–ˆ  โ–€โ–ˆโ–„  โ–’โ–ˆโ–ˆโ–‘    
โ–’โ–ˆโ–ˆโ–‘โ–ˆโ–€  โ–‘โ–ˆโ–ˆโ–‘  โ–’   โ–ˆโ–ˆโ–’โ–‘โ–“โ–ˆ โ–‘โ–ˆโ–ˆ โ–‘โ–ˆโ–ˆโ–„โ–„โ–„โ–„โ–ˆโ–ˆ โ–’โ–ˆโ–ˆโ–‘    
โ–‘โ–“โ–ˆ  โ–€โ–ˆโ–“โ–‘โ–ˆโ–ˆโ–‘โ–’โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–’โ–’โ–‘โ–“โ–ˆโ–’โ–‘โ–ˆโ–ˆโ–“ โ–“โ–ˆ   โ–“โ–ˆโ–ˆโ–’โ–‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–’
โ–‘โ–’โ–“โ–ˆโ–ˆโ–ˆโ–€โ–’โ–‘โ–“  โ–’ โ–’โ–“โ–’ โ–’ โ–‘ โ–’ โ–‘โ–‘โ–’โ–‘โ–’ โ–’โ–’   โ–“โ–’โ–ˆโ–‘โ–‘ โ–’โ–‘โ–“  โ–‘
โ–’โ–‘โ–’   โ–‘  โ–’ โ–‘โ–‘ โ–‘โ–’  โ–‘ โ–‘ โ–’ โ–‘โ–’โ–‘ โ–‘  โ–’   โ–’โ–’ โ–‘โ–‘ โ–‘ โ–’  โ–‘
 โ–‘    โ–‘  โ–’ โ–‘โ–‘  โ–‘  โ–‘   โ–‘  โ–‘โ–‘ โ–‘  โ–‘   โ–’     โ–‘ โ–‘   
 โ–‘       โ–‘        โ–‘   โ–‘  โ–‘  โ–‘      โ–‘  โ–‘    โ–‘  โ–‘
      โ–‘