Skip to content

Echo is your personal AI assistant on Telegram, designed to enhance your productivity by providing a seamless needs. With MongoDB integration, your reminders, schedules, broadcast, APIs and others persist even if the bot restarts, ensuring you never miss a moment.

License

Notifications You must be signed in to change notification settings

theseekerofficial/Echo

Repository files navigation

ECHO v1.2.2 XS7 #IM #NF (Improvements/New Features)

Echo



Readme Contents

Wiki Content

Introduction

Echo, your personal AI assistant on Telegram, is designed to enhance your productivity by providing a seamless experience. With MongoDB integration, your data persist even if the bot restarts, ensuring you never miss a moment. Whether you're managing your schedule in private messages or coordinating group activities, Echo has you covered.

Echo developed from scratch by The Seeker's Cave Organization, it is a standalone project. ๐Ÿฅ‡

Features

Feature_Pack

  1. Universal Usage and Portability: โ™พ๏ธ

    • Works seamlessly in both private messages and any Telegram group where the bot is an admin.
    • We have included all the necessary fonts, graphics, and other elements in the repository to ensure Echo functions as expected and to enhance its portability.
  2. Persistent Storage: ๐Ÿ’ฝ

    • MongoDB integration for storing reminders and user data.
    • Reminders and other user data persist even if the bot restarts.
  3. Token System and Paid User system for Monatize Echo with URL Shortners ๐Ÿ’ธ

    • A token system available for features/plugins command
    • A Paid user system for subscription method. Those who are in the paid users list can bypass the token system
    • The owner can turn on or off the token system as needed.
    • Manage, Delete, and view paid users effortlessly
  4. Custom Timezones: โŒš

    • Set your preferred timezone for personalized reminder notifications.
  5. Imporved Reminders Module: โฐ

    • No limit on the number of reminders you can set in Echo.
    • Recurring (repeating) reminders for minutely, hourly, daily, weekly, monthly, yearly time periods
    • View all active reminders under one command.
    • Edit Reminders function
    • Delete Reminders function
  6. Deployment Support:

    • Deploy on both Render and VPS for flexible hosting options.๐Ÿš€
  7. Meet Your Personal AI Assistant within Echo

    • Echo can generate responses from Google's Most Powerful AI Modle aka Google Gemini. Simply put your API key in the Echo and meet Gemini! ๐Ÿค–
    • Global API setup or user's own API setup mechanism based on your preference.โš™๏ธ
  8. Chatbot powered by Google Gemini

    • Feeling bored? Chat with Echo! Play games with Echo!! Echo replies to anything you say with the support of Google's Gemini Pro.๐Ÿ’ฌ
    • Global API setup or user's own API setup mechanism based on your preference.โš™๏ธ
  9. Image analysis module powered up with Google Gemini

    • Analyse or get descriptions about any of your images using Echo! ๐Ÿ”Ž
  10. Automatically Setting Up Bot Commands

    • No need to manually set up bot commands in BotFather. We got you. Soon as the bot is deployed bot commands will be set automatically๐Ÿ“
  11. Modern and Advanced Broadcast Module/ Super Improved Scheduled Broadcast Module

    • Amplify your voice! Send important updates directly to all your audience with categorized broadcast menu (PM Only Broadcast, Group Only Broadcast, All Chat Broadcast). Designed with easy-to-use Telegram Inline Buttons. [Only Available to Pre-authorized users in config.env]
    • Be a time master with Echo's Scheducast module. Schedule your important broadcast messages with a blink! ๐ŸŒŸ
  12. Easily Update you Echo using UPSTREAM_REPO:

    • Just by sending /restart cmd You can update your echo bot to latest version. โคด๏ธ
  13. External Ping Support:

    • Integrated with Uptimerobot to keep Render instances online. ๐Ÿ“
  14. Custom Ringtones:

    • Type /ringtones to get 4 sample custom ringtones to improve the Reminders. Look at the /help message for more info ๐ŸŽต
  15. All-in-One Calculators

    • Echo includes all the calculators you need for both day-to-day and academic use.
    • Designed using interactive telegram inline buttons
    • Basic Calculator โœ…
    • Scientific Calculator โœ…
    • Unit Converter โœ…
      • Length ๐Ÿ“
      • Volume ๐Ÿ’ง
      • Area โฌ›๏ธ
      • Weight/Mass โš–๏ธ
      • Time โฐ
      • Speed ๐Ÿš—๐Ÿ’จ
      • Pressure ๐Ÿ’จโš–๏ธ
      • Energy โšก๏ธ
      • Power โšก๏ธ๐Ÿ’ช
      • Angle ๐Ÿ“
      • Data Spectrum ๐Ÿ“ถ
      • Fuel Efficiency โ›ฝ๏ธ
      • Temperature ๐ŸŒก๏ธ
      • Cooking ๐Ÿฝ๏ธ
  16. Telegraph Image Uploading

    • Upload any Telegram image to Telegraph and get an instant direct link to your image ๐Ÿ”บ
    • Reply to any image as /uptotgph to see the magic! ๐Ÿช„
  17. Logo Generator

    • Enhance your creativity using Echo's Logo Generator Plugin๐Ÿงฌ
    • /logogen is your magic word! ๐Ÿช„
  18. ShiftX (Advanced Multifile Converter Plugin) ๐Ÿ”„๏ธ

    • What you want to convert?
      • Images?
      • Videos?
      • Documents?
      • Audios?
    • No need to go around websites to convert you files. Echo got your back ๐Ÿค
    • More conversation pairs yet to come โ™พ๏ธ
    • Convert a wide range of files simply within the Telegram Interface ๐Ÿ”ฅ
  19. Doc Spotter (Advanced Auto Filtering)

    • Are you an admin that has a movie group? This plugin is for you.๐Ÿซต
    • Enabled ability to Switch beteen Inline buttons to Inline URL Buttons ๐Ÿฆ˜
    • URL Ad Shortner Support for Doc Spotter Buttons ๐Ÿซฐ๐Ÿ’ธ
    • Feel the power of DocSpotter Plugin ๐Ÿ’ช
      • Multiple F-Sub chats (Channels or Groups)
      • IMDB info and poster fetching
      • Enable or disable IMDb in your preferences.
      • Button dashboard only has access to the user who searches keyword
      • Requested file received in Bot PM
      • Indexing any file type in telegram
      • Delete Indexed Files Easily
  20. Image Background Remover

    • Easily Remove your Images Background Using Echo's Background Remover ๐Ÿ–ผ๏ธโœ‚๏ธ
    • User own Personal and Global API mechanism for more flexibility ๐Ÿฆพ
  21. Chat Cloner [Clonergram]

    • Want to clone a group or channel? Leave it to Echo, /clonegram is the magic word ๐Ÿ’ 
    • Working on both groups and channels โœ”๏ธ
    • Clone only selected message/file types you prefer
      • Text Cloning โœ…
      • Image Cloning โœ…
      • File Cloning โœ…
      • Stiker Cloning โœ…
      • Audio Cloning โœ…
      • Video Cloneing โœ…
  22. IMDb Search

    • Find your favorite movies and TV shows using /imdb ๐Ÿฟ๐ŸŽž๏ธ
  23. Force Subscribe Function

    • Grow your chats with the advanced feature-rich F-Sub Plugin. This plugin will give the opportunity for it ๐Ÿ’ช
    • Subscription checking support for both groups and channels
  24. FileFlex, File Manipulation Plugin (Echo Original Plugin)

    • Add custom captions with custom handlers and HTML Handlers to your files ๐Ÿง‹
    • Add URL Buttons to your files super easily
    • Plugin Modes,
      • Instant Flex โฉ
      • Pre-Configured Flex โš™๏ธ
      • FileFlex Jobs for Chats for automatic FileFlexes ๐Ÿ’ผ
      • Custom Global Templates ๐Ÿ–ผ๏ธ
    • You can modify your files with a ton of possibility using FileFlex Plugin
  25. Info & Utility Modules

    • Simple Modules that could help to you in day-to-day telegram usage ๐Ÿ“…
    • Status of Echo ๐Ÿ“ˆ
      • See Database Usage for Each Database in Echo (/database)
      • Find Your Telegram ID (/info)
      • Find Any Other user Telegram ID (/info)
      • Find Any Other chat(Channel/Group) Telegram ID (/info)
      • See a stats report about Echo and Host Server (/overview)
      • /users Command for Owner to See Echo Using User's and Group Chats list
  26. Commit Detector Function

    • Keep updated about your fav GitHub repo within the telegram environment. This feature can detect new commits from any public repo and send them to your telegram channel(s)/group(s)๐Ÿช„
    • Exclusively for Echo deploying owners only
  27. CadeCapsule Module for Run Supporter Plugins

    • Codecapsule is a file management system that allows Echo to run separate supporter plugins in different screen sessions. ๐Ÿš€
    • These supporter plugins are improve to functionality of the main plugins in Echo

Super Plugins

1) Guardian

Guardian boasts a highly user-friendly interface and is a super customizable group manager plugin. We're excited to launch the initial version of Guardian with these 5 major features ๐Ÿ›ก๏ธ:

  1. Welcomer ๐ŸŽŠ

    • Send a costomized welcome message when a user join your group
    • Supports text messages, media, and URL buttons with HTML and custom handlers like ([id], [first_name], ...)
    • Linked to Logger to log every user join when logger mode is enabled
    • Group topic support
    • And many more features
  2. Goodbye ๐Ÿ™‹โ€โ™‚๏ธ

    • Send a costomized goodbye message when a user leave your group
    • Similar to Welcomer, supports text, media, and URL buttons with HTML and special handlers
    • Topic support
    • Linked to Logger
  3. Rules โš ๏ธ

    • Supports displaying URL based rules
    • Text, media, and URL button support
    • In-group /rules command support
    • Capable of linking group rules to Welcomer, Goodbye, and Captcha
  4. Logger ๐Ÿ“œ

    • Supports logging every event of every other features
    • Ability to toggle only needed logging elements in the dashboard
    • Can set up Logging Chat for both groups and channels
    • Provides detailed information about the event
  5. Captcha ๐Ÿง  (The most advanced and largest module we created in Echo)

    • Supports 5 types of captcha: Button, Math, Rule Acceptation, reCaptcha, Quiz
    • Customizable messages for some types of captcha modes (Custom Text with Special Handlers, Media, and URL Buttons)
    • Group topic support
    • A range of punishments set (Mute, Kick, Ban, Do Nothing)
    • Auto Punishment Executor
    • Audio (TTS) support for reCAPTCHA
    • Wide range of quiz sets
    • Captcha Auto - Regenerating System
    • Support to enable or disable captcha system for invited users (Users who not joined via invite links)
  6. Link Generator ๐Ÿ”—

    • Generate a invite link instantly using /link command
    • Set custom user limits, expire durations and enable approval mode based on admins need
    • Revoke generated invite links easily
    • Set a Public Invite link for members of the group. When members send /link command they will see the public invite link

Commands

  • /start: Initiate the bot and receive a warm welcome.๐Ÿ‘‹
  • /help: To get help message and more info.๐Ÿค
  • /broadcast: Amplify your voice! Send important updates directly to all your followers.๐Ÿ“ข")
  • /scheducast: Be a master of time. Schedule your broadcasts using Echo's Scheducast module๐Ÿ“ข")
  • /gemini [text]: Meet Your Personal AI Assistant, Google Gemini ๐Ÿค–
  • /chatbot: Chat with Echo's Chatbot๐Ÿ’ฌ
  • /mygapi: Setup Your Google G-API๐Ÿ”—
  • /analyze4to: Start the image analyze using AI๐Ÿ”
  • /showmygapi: Check your current G-API โœ…
  • /delmygapi: Delete Your G-API from Echo's Database ๐Ÿ—‘๏ธ
  • /uptotgph: Upload any telegram image to Telegraph and get instant direct link ๐Ÿš€
  • /logogen: Craft your own logo with endless possibilities. (with Support for adding your own graphics, frames and more) ๐ŸŽจ๐Ÿ–Œ๏ธ
  • /codecapsule : Run Supporter Plugins ๐Ÿš€โšก
  • /imdb : Find your fav movies and TV shows using /imdb ๐Ÿฟ๐ŸŽž๏ธ
  • /docspotter: Advanced auto filter feature packed with all feature you need for file managing ๐Ÿ—ƒ๏ธ
  • /erasefiles: Delete indexed files easily โ™ป๏ธ
  • /shiftx: Convert wide range of files using Echo's ShiftX Plugin โ™ป๏ธ
  • /clonegram: Clone any type of message between chats ๐Ÿ”€
  • /fsub: Create a Force Subscribe Taks for a chat โš–๏ธ
  • /setreminder: Set a reminder for a specific date and time.๐Ÿ—“๏ธ
  • /myreminders: To see all your active reminders.๐Ÿ“ƒ
  • /editreminders: Edit Your remindersโœ๏ธ
  • /delreminder: Delete unnecessary reminders in a flash ๐Ÿ—‘๏ธ
  • /settimezone TIMEZONE: Customize your preferred timezone for reminder notifications.โณ
  • /ringtones: Get uncommon ringtone files for set to Echo Reminder Bot.๐ŸŽต
  • /info: See User/Bot/Chat info ๐Ÿ“œ
  • /removebg: Remove background from any image ๐Ÿช„
  • /rbgusage: See your RemoveBG API Usage ๐Ÿ“ˆ
  • /moreinfo: Unbox the secrets! Type /moreinfo for the full bot lowdown & bonus notes.๐Ÿ“š
  • /users: Get users and groups list that uses Echo ๐Ÿ‘ฅ
  • /addpaid: Add a paid user ๐Ÿ’ธ
  • /paid: see paid user(s) info ๐Ÿ“œ
  • /database: Get database stats ๐Ÿ“Š
  • /bsettings: Config Echo easily โš™๏ธ
  • /restart: Restart your bot and Update to the letest version โคด๏ธ

You can discover additional sub-commands within the /help command that may not be explicitly listed.

What are Supporter Plugins ๐Ÿค

โ“ Supporter Plugins are auxiliary scripts that work in conjunction with the main Echo Environment, designed to enhance the functionality of the primary plugins used by an Echo bot. These plugins are separate codes that do not run directly within the main Echo Environment but are managed through it. Hereโ€™s a bit more detail about how they operate and the available plugins

โ“ Supporter Plugins utilize the codecapsule.py module within the Echo client, ensuring seamless integration and control from the main Echo Environment.

โ“ They use Linux screen sessions to remain active and operational, ensuring that they can continue running independently without requiring constant user intervention.

โšก You can find more info in the supporter-plugins branch

โšก current Available Supporter Plugins:

  • TeleFileDex.py (For index history of a channel or group for Doc Spotter Plugin)
  • TeleCloner.py (For Clone chat history to destination chat. Supporter Plugin for Clonegram main Plugin)
  • SafeSync.py (Mongodb Backup code for main Echo Client database)

Usage

โš™๏ธ. Start a Chat:

  • Begin a conversation with the bot either by searching on Telegram or using the provided link.

โš™๏ธ. Simple Commands:

  • Use intuitive commands like /start to initiate the bot and /setreminder to schedule reminders.

โš™๏ธ. Personalize Time Zone:

  • Optionally set your preferred timezone using the /settimezone command.

โš™๏ธ. Group Friendly:

  • Set reminders effortlessly in groups by mentioning the bot (@YourBotUsername) followed by the /setreminder command.

โš™๏ธ. Control Usage of Echo

  • Control the bot access to users using "GO_PUBLIC" and "ALLOWED_CHATS" ENVs

Configure Echo

This section provides detailed information on the required environment variables for configuring Echo in the config.env file. These environment variables are essential for the proper functioning of your Echo bot. Please follow the instructions below to set up your environment variables before running the bot.

Required Environment Variables (๐Ÿ”ด)

Primary

  1. TOKEN [๐Ÿ”ด]

    • Description: Bot Token Generated by BotFather
    • Example: TOKEN=your_bot_token_here
  2. MONGODB_URI [๐Ÿ”ด]

    • Description: Your MongoDB URI
    • Example: MONGODB_URI=mongodb://username:password@localhost:27017/echo_database
  3. OWNER [๐Ÿ”ด]

    • Description: Owner ID of echo
    • Example: OWNER=123456789
  4. UPSTREAM_REPO_URL [๐Ÿ”ด]

    • Description: Your fork repo URL or Official repo link
    • Example: UPSTREAM_REPO_URL=https://github.com/theseekerofficial/Echo

Secondary

  1. REMINDER_CHECK_TIMEZONE [๐Ÿ”ด]

    • Description: Set a global timezone for reminders.
    • Example: REMINDER_CHECK_TIMEZONE=America/New_York
  2. AUTHORIZED_USERS [๐Ÿ”ด]

    • Description: Give access to users special modules like broadcast, scheducast, etc. (comma-separated list of user IDs or usernames)
    • Example: AUTHORIZED_USERS=123456789,987654321,147852369
  3. SCEDUCAST_TIMEZONE [๐Ÿ”ด]

    • Description: Set a preferred timezone for the scheducast module.
    • Example: SCEDUCAST_TIMEZONE=Asia/Tokyo
  4. SCEDUCAST_TIME_OFFSET [๐Ÿ”ด]

    • Description: Set the correct time offset for the timezone you mentioned in SCEDUCAST_TIMEZONE. The offset should be in hours and minutes.
    • Example: SCEDUCAST_TIME_OFFSET=9.5
    • Explanation: If your local timezone is Asia/Colombo, and it is 5 hours and 30 minutes ahead of UTC, you should set this value to 5.5.

Optional But Recommended to Fill Environment Variables (๐Ÿ”ถ)

Echo Profile Setup

  1. SETUP_BOT_PROFILE [๐Ÿ”ถ]

    • Description;
      • You have been advised to set SETUP_BOT_PROFILE environment variable to False after you set up your Echo profile correctly during the first deployment using /bsettings to prevent unnecessary rate limit errors.
      • Set True to set up the Echo profile automatically. If you keep this env as empty or False you will have to set the bot profile manually in BotFather
    • Example: SETUP_BOT_PROFILE=True
  2. BOT_NAME [๐Ÿ”ถ]

    • Description: Enter a new name for Echo
    • Example: BOT_NAME=๏ผฅ๏ฝƒ๏ฝˆ๏ฝ
  3. BOT_ABOUT [๐Ÿ”ถ]

    • Description: Enter a new about text for Echo. โš ๏ธ Remember about Telegram about text limits. keep the about text shorter
    • Example: BOT_ABOUT=Echo is your All-in-One AI Personal Assistant ๐Ÿค–
  4. BOT_DESCRIPTION [๐Ÿ”ถ]

    • Description: Enter a new description for Echo
    • Example: BOT_DESCRIPTION=Echo is a personal AI assistant on Telegram that enhances productivity through the seamless integration of reminders, schedules, broadcasts, and many more features.๐Ÿƒ

Optional Environment Variables (๐ŸŸฉ)

Feature Configurations and Others

  1. DS_IMDB_ACTIVATE [๐ŸŸฉ]

    • Description: Set True or Flase to Enable or Disable IMDb Poster and Info in Doc Spotter Button List message
    • Example: DS_IMDB_ACTIVATE=True
  2. DS_URL_BUTTONS [๐ŸŸฉ (Required to be True for URL Shortner feature to work)]

    • Description: Set True or Flase to Enable or Disable URL Buttons for Result list in DS Plugin | This ENV needs to set True for URL Shortner feature to work
    • Example: DS_URL_BUTTONS=True
  3. GO_PUBLIC [๐ŸŸฉ]

    • Description: Set to True for available Echo for all users in telegram. | Set to False to restrict Echo's usage to chats in ALLOWED_CHATS
    • Example: GO_PUBLIC=True
  4. ALLOWED_CHATS [๐ŸŸฉ]

    • Description: List of chat IDs (USER IDs or GROUP IDs | Both types acceptable) that allow to use Echo
    • Note: This ENV only works if the GO_PUBLIC env is set to "False"
    • Example: ALLOWED_CHATS=123456789,-100987654321,192837465
  5. URL_SHORTNER

    • Fill your shortener's domain.
    • To disable this URL shortener feature, keep empty these envs
    • Supported Shortners: atglinks.com, exe.io, gplinks.in, shrinkme.io, urlshortx.com, shortzon.com, shorte.st, ouo.io
    • Example: URL_SHORTNER=https://atglinks.com
  6. URL_SHORTNER_API

    • Description: Fill your shortener's api.
    • To disable this URL shortener feature, keep empty these envs
    • Supported Shortners: atglinks.com, exe.io, gplinks.in, shrinkme.io, urlshortx.com, shortzon.com, shorte.st, ouo.io
    • Example: URL_SHORTNER_API=dhoyj96oh4j50j90j5uy3g40y045h32tr473g4t804t
  7. GH_CD_URLS [๐ŸŸฉ (Required if GH_CD_CHANNEL_IDS ENV was Filled)]

    • Description: Fill in the repo URL in the format theseekerofficial/Echo.
    • Example: GH_CD_URLS=theseekerofficial/Echo
  8. GH_CD_CHANNEL_IDS [๐ŸŸฉ (Required if GH_CD_URLS ENV was Filled)]

    • Description: Add the Channel ID(s)/Group ID(s) that you need to post-commit update.
    • Example: GH_CD_CHANNEL_IDS=-100123456789
  9. GH_CD_PAT [๐ŸŸฉ]

    • Description: Your GitHub Personal Authorization Token for 5000 requests per hour API calls.
    • Example: GH_CD_CHANNEL_IDS=ujb32uvb579g29824t89v245h8
  10. ENABLE_GLOBAL_G_API [๐ŸŸฉ]

    • Description: Enable Global API for AI-related features (True or False)
    • Example: ENABLE_GLOBAL_G_API=True
  11. GLOBAL_G_API [๐ŸŸฉ]

    • Description: Add your API key from Google AI Studios
    • Example: GLOBAL_G_API=urwgui598t42598bgt589t5
  12. SHIFTX_MP3_TO_AAC_BITRATE [๐ŸŸฉ]

    • Description: Set a quality for MP3 to AAC Outputs. Set a value among 128k, 192k, 256k, 320k | 128k = Lowest quality, smallest file size / 320k = highest quality, largest file size.
    • Example: SHIFTX_MP3_TO_AAC_BITRATE=192k
  13. SHIFTX_AAC_TO_MP3_BITRATE [๐ŸŸฉ]

    • Description: Set a quality for ACC to MP3 Outputs. Set a value among 128k, 192k, 256k, 320k | 128k = Lowest quality, smallest file size / 320k = highest quality, largest file size.
    • Example: SHIFTX_AAC_TO_MP3_BITRATE=256k
  14. SHIFTX_OGG_TO_MP3_QUALITY [๐ŸŸฉ]

    • Description: Set a quality for OGG to MP3 Outputs. Set a value from 0 to 9 | 9 = Lowest quality, smallest file size / 0 = highest quality, largest file size.
    • Example: SHIFTX_OGG_TO_MP3_QUALITY=5
  15. SHIFTX_MP3_TO_OGG_QUALITY [๐ŸŸฉ]

    • Description: Set a quality for MP3 to OGG Outputs. Set a value from -1 to 10 | -1 = Lowest quality, smallest file size / 10 = highest quality, largest file size.
    • Example: SHIFTX_MP3_TO_OGG_QUALITY=4
  16. REMOVEBG_API [๐ŸŸฉ]

    • Description: Set a Global API Key for RemoveBG Plugin. Get one from RemoveBG
    • Example: REMOVEBG_API=abcdefgh12345678
  17. RESTART_AT_EVERY [๐ŸŸฉ]

    • Description: Set True to send F-Sub user to inform message in PM and Group. Set False to send F-Sub user to inform message only in Group.
    • Example: FSUB_INFO_IN_PM=True
  18. FSUB_INFO_IN_PM [๐ŸŸฉ]

    • Description: Set a time to auto restart to Echo (Fill in seconds). 24hours = 86400
    • The minimum time that can be set for this env is 600
    • To Disable auto restart, set this ENV to 0
    • Example: RESTART_AT_EVERY=86400

Plugin On/Off

  1. GEMINI_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Gemini Text Plugin.
    • Example: GEMINI_PLUGIN=True
  2. CHAT_BOT_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Chatbot Plugin.
    • Example: CHAT_BOT_PLUGIN=True
  3. GEMINI_IMAGE_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Gemini Image Analysis Plugin.
    • Example: GEMINI_IMAGE_PLUGIN=True
  4. CALCULATOR_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Calculator Plugin.
    • Example: CALCULATOR_PLUGIN=True
  5. SCI_CALCULATOR_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Scientific Calculator Plugin.
    • Example: SCI_CALCULATOR_PLUGIN=True
  6. UNIT_CONVERTER_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Units Converter Plugin.
    • Example: UNIT_CONVERTER_PLUGIN=True
  7. TELEGRAPH_UP_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Telegraph Image Upload Plugin.
    • Example: TELEGRAPH_UP_PLUGIN=True
  8. LOGOGEN_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Logo Gen Plugin.
    • Example: LOGOGEN_PLUGIN=True
  9. DOC_SPOTTER_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Doc Spotter Plugin.
    • Example: DOC_SPOTTER_PLUGIN=True
  10. SHIFTX_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the ShiftX Plugin.
    • Example: SHIFTX_PLUGIN=True
  11. REMOVEBG_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the RemoveBG Plugin.
    • Example: REMOVEBG_PLUGIN=True
  12. IMDb_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the IMDb Plugin.
    • Example: IMDb_PLUGIN=True
  13. CLONEGRAM_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the Clonegram Plugin.
    • Example: CLONEGRAM_PLUGIN=True
  14. F_SUB_PLUGIN [๐ŸŸฉ]

    • Description: Set to True or False to Enable or Disable the F-Sub Plugin.
    • Example: F_SUB_PLUGIN=True
  15. FILEFLEX_PLUGIN [๐ŸŸฉ]

    • Description: Set True or False to Enable or Disable Fileflex Plugin
    • Example: FILEFLEX_PLUGIN=True

Make sure to replace the placeholder values with your actual configuration settings. These environment variables are crucial for customizing and configuring the behavior of your Echo bot. Ensure that they are correctly set before running the bot to ensure its proper functionality.

If you have any questions or need further assistance, please refer to the documentation or reach out to the Echo support team.

Deployment

๐Ÿš€VPS

~Pre-Requiremtnts

  • Make sure to install Python 3.10 installed in your Ubuntu system. If you only have a version like Python 3.8, Install Python 3.10 too

Run directly in python


~Deploying Steps

  1. Give a Star to https://github.com/theseekerofficial/Echo ๐Ÿ˜‰
  2. Fork the Repo
  3. Set up a MongoDB database and obtain the connection URI.
  4. Rename rename_me_as_config.env as config.env
  5. Fill config.env as described above
  6. Clone the repository: git clone https://github.com/your_username/Echo.git
  7. To Creating Virtual Environment, Run python3.10 -m venv venv in your server terminal
  8. Activate the virtual environment using source venv/bin/activate
  9. Install required Python packages: pip install -r requirements.txt
  10. Update System sudo apt update
  11. Install ffmpeg for ShiftX Plugin and screen for CodeCapsule Module ( Optional but Recommended | If you skip installation, Echo will dynamically install ffmpeg and screen itself ) sudo apt install -y ffmpeg screen
  12. Run the bot: python bot.py or python3 bot.py

All-in-One Deploy CMDs for VPS (Make Sure to install python3.10 in your server)

deactivate
cd
rm -rf Echo
git clone https://github.com/theseekerofficial/Echo
cd Echo
python3.10 -m venv venv
source venv/bin/activate
sudo apt update
sudo apt install -y ffmpeg screen
pip install -r requirements.txt
python3 bot.py

Use a method like Linux Screen to keep your Echo online 24/7 when using VPS deployment

Run Using Docker


~Deploying Steps

  1. Give a Star to https://github.com/theseekerofficial/Echo ๐Ÿ˜‰
  2. Fork the Repo
  3. Set up a MongoDB database and obtain the connection URI.
  4. Rename rename_me_as_config.env as config.env
  5. Fill config.env as described above
  6. Clone the repository: git clone https://github.com/your_username/Echo.git
  7. Run this
    docker build -t echo .
    
  8. After building Docker Image, run this
    docker run -p 8000:8000 echo
    
  9. Enjoy โœจ

๐Ÿš€Render

  1. Give a Star to https://github.com/theseekerofficial/Echo ๐Ÿ˜‰
  2. Fork the Repo
  3. Edit and Fill necessary environment variables in config.env
  4. Create a new web service in your render account and click "Build and deploy from a Git repository" Render1
  5. Connect your GitHub account to render if you repo private other vise copy your public GitHub repo (Not recommended) and paste it to render dashbord Render2
  6. Give a Name for you web service and fill python bot.py in Start Command. Follow provided photo Render3
  7. Select a Instance Type [Recommended: 512 MB (RAM) | Free$0/ month 0.1 CPU] Render4
  8. Click "Create Web Service" Button Render5
  9. Wait Until deploy complete. Keep alert in the log to check is there any errors. If you deploy success you need to get something like this in the log Render6
  10. After deploy complete, copy your Webhook URL (Something like https://{your_project_name}.onrender.com). You can find it in the top of your deployment page Render7
  11. Not go to https://uptimerobot.com/ and create an account, after that Fallow this, Click Add New Monitor Button > Monitor Type: HTTP(s) > Give any Friendly Name as you wish > Fill URL (or IP) as this :- {your_render_webhook_url} > and click Create Monitor Render8
  12. Now Bot has successfully deployed to Render

Demo Bot

  • Test the lestest version of code using this demo bot,
  • Did you know you can make this bot your personal assistant? Not only can it handle reminders for you, but you can also use other plugins too as you needs. ๐Ÿš€ However, for the best experience, we recommend deploying your very own ECHO!

Deployed in Render Echo

Creator Details

Crafted๐Ÿ”จ with ๐Ÿ–ค by ๐“ฃ๐“ฑ๐“ฎ ๐“ข๐“ฎ๐“ฎ๐“ด๐“ฎ๐“ป

  • Name: ๐“ฃ๐“ฑ๐“ฎ ๐“ข๐“ฎ๐“ฎ๐“ด๐“ฎ๐“ป
  • Telegram: @MrUnknown114
  • GitHub: GitHub Profile

LICENSE

Proofreaded by, @The_Seeker_116 ๐Ÿ“–โœ”๏ธ

Enhanced by,

- OpenAI's GPT3.5 & GPT-4 ๐Ÿช„
- Google Gemini โœจ
- Codeium ๐Ÿฆพ

Feel free to connect with the creator for inquiries or support related to Echo in ECHO Support Unit. Enjoy using Echo and stay organized!

#ECHO #EchoAIO #Made_From_Scratch

About

Echo is your personal AI assistant on Telegram, designed to enhance your productivity by providing a seamless needs. With MongoDB integration, your reminders, schedules, broadcast, APIs and others persist even if the bot restarts, ensuring you never miss a moment.

Topics

Resources

License

Stars

Watchers

Forks

Languages