{"id":17017981,"url":"https://github.com/vijethph/vitelbot","last_synced_at":"2026-02-02T20:08:55.572Z","repository":{"id":49050239,"uuid":"261185328","full_name":"vijethph/VitelBot","owner":"vijethph","description":"A Telegram bot made in Python","archived":false,"fork":false,"pushed_at":"2025-02-23T10:42:29.000Z","size":1201,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T07:40:05.609Z","etag":null,"topics":["python","python-telegram-bot","telegram-api"],"latest_commit_sha":null,"homepage":null,"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/vijethph.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-04T13:29:35.000Z","updated_at":"2025-02-23T10:42:31.000Z","dependencies_parsed_at":"2024-05-21T08:57:07.640Z","dependency_job_id":"454b74c3-a911-47c6-b80f-518a0540e28a","html_url":"https://github.com/vijethph/VitelBot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vijethph/VitelBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vijethph%2FVitelBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vijethph%2FVitelBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vijethph%2FVitelBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vijethph%2FVitelBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vijethph","download_url":"https://codeload.github.com/vijethph/VitelBot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vijethph%2FVitelBot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263887544,"owners_count":23525500,"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":["python","python-telegram-bot","telegram-api"],"created_at":"2024-10-14T06:44:11.817Z","updated_at":"2026-02-02T20:08:53.476Z","avatar_url":"https://github.com/vijethph.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Status](https://img.shields.io/badge/status-active-success.svg?style=flat-square)]()\r\n[![GitHub issues](https://img.shields.io/github/issues/vijethph/VitelBot?style=flat-square)](https://github.com/vijethph/VitelBot/issues)\r\n[![Contributors](https://img.shields.io/github/contributors/vijethph/VitelBot?style=flat-square)](https://github.com/vijethph/VitelBot/graphs/contributors)\r\n[![GitHub forks](https://img.shields.io/github/forks/vijethph/VitelBot?color=blue\u0026style=flat-square)](https://github.com/vijethph/VitelBot/network)\r\n[![GitHub stars](https://img.shields.io/github/stars/vijethph/VitelBot?color=yellow\u0026style=flat-square)](https://github.com/vijethph/VitelBot/stargazers)\r\n[![GitHub license](https://img.shields.io/github/license/vijethph/VitelBot?style=flat-square)](https://github.com/vijethph/VitelBot/blob/master/LICENSE)\r\n[![made-with-python](https://img.shields.io/badge/Made%20with-Python-blueviolet.svg?style=flat-square)](https://www.python.org/)\r\n[![Docker Build](https://img.shields.io/badge/docker%20build-passing-bluegreen.svg?style=for-the-badge\u0026logo=docker\u0026labelColor=blue\u0026logoColor=white)](https://hub.docker.com/r/vijethph/vitelbot)\r\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\r\n\r\n\u003cbr /\u003e\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://github.com/vijethph/VitelBot\"\u003e\r\n    \u003cimg src=\"logod.png\" alt=\"Logo\" width=\"100\" height=\"100\"\u003e\r\n  \u003c/a\u003e\r\n\r\n  \u003ch2 align=\"center\"\u003eVitelBot\u003c/h2\u003e\r\n\r\n  \u003cp align=\"center\"\u003e\r\n    A Telegram Bot made in Python, that can perform a variety of tasks, based on requests to certain APIs.\r\n    \u003cbr /\u003e\r\n    \u003cbr /\u003e\r\n    \u003ca href=\"https://github.com/vijethph/VitelBot/issues\"\u003eReport Bug\u003c/a\u003e\r\n    ·\r\n    \u003ca href=\"https://github.com/vijethph/VitelBot/issues\"\u003eRequest Feature\u003c/a\u003e\r\n  \u003c/p\u003e\r\n\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- TABLE OF CONTENTS --\u003e\r\n## Table of Contents\r\n\r\n* [About the Project](#about-the-project)\r\n  * [Built With](#built-with)\r\n* [Getting Started](#getting-started)\r\n  * [Prerequisites](#prerequisites)\r\n  * [Installation](#installation)\r\n* [Usage](#usage)\r\n* [Contributing](#contributing)\r\n* [License](#license)\r\n* [Contact](#contact)\r\n* [Acknowledgements](#acknowledgements)\r\n\r\n\r\n\r\n\u003c!-- ABOUT THE PROJECT --\u003e\r\n## About The Project\r\n\r\n\u003ccenter\u003e\u003ca href=\"screenshot1.jpg\"\u003e\u003cimg src=\"screenshot1.jpg\" height=\"450\" width=\"210\" \u003e\u003c/a\u003e\r\n\u003ca href=\"screenshot2.jpg\"\u003e\u003cimg src=\"screenshot2.jpg\" height=\"450\" width=\"210\" \u003e\u003c/a\u003e\u003c/center\u003e\r\n\r\nThis is a Telegram Bot made with Python that uses [python-telegram-bot](https://python-telegram-bot.org) wrapper which can perform a variety of tasks, like getting a random number, a random joke, cat and dog pictures, and also memes. It can easily be accessed by Telegram Users by opening this link: [VitelBot](https://t.me/@VijethsTestingBot).\r\n\r\n\r\n\r\n### Built With\r\nThis project is entirely built with the following components and languages:\r\n* [Python](https://www.python.org)\r\n* [python-telegram-bot wrapper](https://python-telegram-bot.org)\r\n\r\n\u003c!-- GETTING STARTED --\u003e\r\n## Getting Started\r\n\r\nThe Telegram Bot can easily be accessed by opening this link: https://t.me/VijethsTestingBot. Telegram Users can then send queries to the bot by issuing listed commands. In order to build this bot manually, and get a local copy of the Python program up and running follow these simple steps.\r\n\r\n### Prerequisites\r\n\r\nTelegram App must be installed for this interacting with this Bot. First, grab an API key for your Telegram Bot by following these steps:\r\n\r\n1. Make sure you have an Telegram account. Start Telegram's BotFather Bot by opening this link: https://t.me/BotFather\r\n2. Issue /newbot command. The BotFather bot asks you the bot's name, its picture and other details. Enter them according to your needs.\r\n3. Finally BotFather issues an API key for the bot that you have created. **Store the API key securely, and don't share it with anyone.**\r\n\r\n\r\nNext, to make the bot work, it needs to be programmed with this script. For that, Python\u003e=3.7 and pip\u003e=19.2 should be installed. After installation, check their versions using\r\n\r\n```python\r\npython --version\r\npip --version\r\n```\r\n\r\n\r\n### Installation\r\n\r\n1. Clone the repo\r\n```git\r\ngit clone https://github.com/vijethph/VitelBot.git\r\n```\r\n2. Open the downloaded folder\r\n```sh\r\ncd VitelBot\r\n```\r\n3. Install the packages listed in `requirements.txt` using the following command:\r\n```python\r\npip install -r requirements.txt\r\n```\r\n4. Open `main.py`, replace TOKEN with your API key in single quotes, and MODE with 'dev', i.e.,\r\n```python\r\nTOKEN = 'your-API-key'\r\nMODE = 'dev'\r\n```\r\n5. Finally run the program using\r\n```python\r\npython main.py\r\n```\r\nThe Bot can now be used by issuing commands to it.\r\n\r\nAnother way to install this app is to use it's Docker Image, which is available at [DockerHub](https://hub.docker.com/r/vijethph/vitelbot). [Docker](https://www.docker.com/) should be installed in your system. Just run these commands to pull the image and start the container:\r\n```\r\ndocker pull vijethph/vitelbot\r\ndocker run -p 8443:8443 -e TOKEN='yourapikey' -e MODE='dev' vijethph/vitelbot\r\n```\r\nWhere `'yourapikey'` should be replaced with your API key (with single quotes).\r\n\r\nIf you wish to deploy the bot to Heroku (so that it stays online all the time), simply click `'Deploy to Heroku'` badge shown above. You need to have a Heroku account for doing this. Then, in Heroku Dashboard, go to App settings, add these Environment Variables:\r\n```\r\nkey : TOKEN, value : your-API-key\r\nkey : MODE, value : prod\r\n```\r\n\r\n\u003c!-- USAGE EXAMPLES --\u003e\r\n## Usage\r\n\r\nWhen the bot is opened in Telegram, press Start. It will introduce itself. Users will see a list of commands that can be issued to the bot. All the commands begin with the prefix '/'. So press '/' to view the commands, and choose any one of them to get the required output.\r\n\r\n\r\n\r\n\u003c!-- CONTRIBUTING --\u003e\r\n## Contributing [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat-square)](https://github.com/vijethph/VitelBot/pulls)\r\n\r\n\r\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\r\n\r\n1. Fork the Project\r\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\r\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\r\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\r\n5. Open a Pull Request\r\n\r\n\r\n\r\n\u003c!-- LICENSE --\u003e\r\n## License\r\n\r\nDistributed under the GNU GPL License.\r\n\r\n\r\n\r\n\u003c!-- CONTACT --\u003e\r\n## Contact\r\n\r\nVijeth P H - [@vijethph](https://github.com/vijethph)\r\n\r\nProject Link: [https://github.com/vijethph/VitelBot](https://github.com/vijethph/VitelBot)\r\n\r\n## Thank You!\r\n\r\nMade with ❤  in India.\r\n\r\nIf you like this project, please ⭐ this repo and share it with others 👍\r\n\r\n\r\n\u003c!-- ACKNOWLEDGEMENTS --\u003e\r\n## Acknowledgements\r\n* [Python Docs](https://docs.python.org)\r\n* [Img Shields](https://shields.io)\r\n* [Choose an Open Source License](https://choosealicense.com)\r\n* [python-telegram-bot Docs](https://python-telegram-bot.readthedocs.io/en/stable/)\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvijethph%2Fvitelbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvijethph%2Fvitelbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvijethph%2Fvitelbot/lists"}