Echo

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 33 Open GitHub ↗

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.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

----

[![](https://img.shields.io/github/repo-size/theseekerofficial/Echo?color=blue&label=Repo%20Size&labelColor=333333)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/commit-activity/m/theseekerofficial/Echo?logo=github&labelColor=333333&label=Github%20Commits&color=red)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/license/theseekerofficial/Echo?style=flat&label=License&labelColor=333333&color=yellow)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/)|[![](https://img.shields.io/github/issues-raw/theseekerofficial/Echo?style=flat&label=Open%20Issues&labelColor=333333&color=purple)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/issues-closed-raw/theseekerofficial/Echo?style=flat&label=Closed%20Issues&labelColor=333333&color=orange)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/issues-pr-raw/theseekerofficial/Echo?style=flat&label=Open%20Pull%20Requests&labelColor=333333&color=lightgrey)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/issues-pr-closed-raw/theseekerofficial/Echo?style=flat&label=Closed%20Pull%20Requests&labelColor=333333&color=green)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/)
:---:|:---:|
[![](https://img.shields.io/github/languages/count/theseekerofficial/Echo?style=flat&label=Total%20Languages&labelColor=333333&color=teal)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/languages/top/theseekerofficial/Echo?style=flat&logo=python&labelColor=333333&color=lightblue)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/last-commit/theseekerofficial/Echo?style=flat&label=Last%20Commit&labelColor=333333&color=9cf)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://badgen.net/github/branches/theseekerofficial/Echo?label=Total%20Branches&labelColor=333333&color=violet)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/)|[![](https://img.shields.io/github/forks/theseekerofficial/Echo?style=flat&logo=github&label=Forks&labelColor=333333&color=ff69b4)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/) [![](https://img.shields.io/github/stars/theseekerofficial/Echo?style=flat&logo=github&label=Stars&labelColor=333333&color=yellowgreen)](https://raw.githubusercontent.com/theseekerofficial/Echo/main/)
[![](https://img.shields.io/badge/ECHO%20Updates%20Channel-Join-9cf?style=for-the-badge&logo=telegram&logoColor=blue&style=flat&labelColor=333333)](https://t.me/Echo_AIO) |[![](https://img.shields.io/badge/ECHO%20Support%20Unit-Join-9cf?style=for-the-badge&logo=telegram&logoColor=blue&style=flat&labelColor=333333)](https://t.me/ECHO_Support_Unit) |

</div>

---

## Readme Contents
- [Introduction](#introduction)
- [Features](#features)
- [Super Plugins](#super-plugins)
- [Commands](#commands)
- [Supporter Plugins](https://github.com/theseekerofficial/Echo/tree/supporter-plugins)
    - [What are Supporter Plugins](#what-are-supporter-plugins-)
- [Usage](#usage)
- [Configure Echo](#configure-echo)
- [Deployment](#deployment)
    - [VPS](#vps)
        - [Direct](#Run-directly-in-python)
        - [Docker](#Run-Using-Docker)     
    - [Render](#render)
- [Demo Bot](#demo-bot)
- [Creator Details](#creator-details)

## Wiki Content
- [Home](https://github.com/theseekerofficial/Echo/wiki)
- [Why Echo?🤔](https://github.com/theseekerofficial/Echo/wiki/Why-Echo%3F%F0%9F%A4%94)
- [Features🧩](https://github.com/theseekerofficial/Echo/wiki/Features%F0%9F%A7%A9)
- [Yet to Come 🎯](https://github.com/theseekerofficial/Echo/wiki/Yet-to-Come-%F0%9F%8E%AF)
- [Credits 🤝](https://github.com/theseekerofficial/Echo/wiki/Credits-%F0%9F%A4%9D)

# 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

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 ✅
      
23. **IMDb Search**
    - Find your favorite movies and TV shows using /imdb 🍿🎞️
     
25. **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
      
26. **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

27. **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

28. **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
    - 
29. **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](https://telegram.me/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](https://aistudio.google.com/app/apikey)
    - 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](https://www.remove.bg/dashboard#api-key)
    - 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.](https://t.me/ECHO_Support_Unit)

# 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
-------------------------------------------------------------------------------------

## 🚀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](https://telegra.ph/file/272a6339cefb39cd2cbf3.jpg)
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](https://telegra.ph/file/64d2374b90f02c16515c1.jpg)
6. Give a Name for you web service and fill `python bot.py` in Start Command. Follow provided photo
![Render3](https://telegra.ph/file/abc352875450e7207b611.jpg)
7. Select a Instance Type [Recommended: 512 MB (RAM) | Free$0/ month 0.1 CPU]
![Render4](https://telegra.ph/file/a94474e10aaddfb4f5dc8.jpg)
8. Click "Create Web Service" Button
![Render5](https://telegra.ph/file/23f6f6b7440ce10c54866.jpg)
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](https://telegra.ph/file/f50f10b967db275a8a276.jpg)
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](https://telegra.ph/file/36cbeb8b0d5e3e839f705.jpg)
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](https://telegra.ph/file/9a4ccb39ee8a3cbd0f7e6.jpg)
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](https://t.me/Echo_Reminder_Bot)
   
# Creator Details

Crafted🔨 with 🖤 by 𝓣𝓱𝓮 𝓢𝓮𝓮𝓴𝓮𝓻

- **Name:** 𝓣𝓱𝓮 𝓢𝓮𝓮𝓴𝓮𝓻
- **Telegram:** [@MrUnknown114](https://t.me/MrUnknown114)
- **GitHub:** [GitHub Profile](https://github.com/theseekerofficial)

![LICENSE](https://www.gnu.org/graphics/gplv3-127x51.png)

Proofreaded by, [@The_Seeker_116](https://t.me/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](https://t.me/ECHO_Support_Unit).
Enjoy using Echo and stay organized!

#ECHO #EchoAIO #Made_From_Scratch

Echo

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README