{"id":15035825,"url":"https://github.com/teamultroid/ultroid","last_synced_at":"2025-05-13T21:03:19.510Z","repository":{"id":36957797,"uuid":"341038602","full_name":"TeamUltroid/Ultroid","owner":"TeamUltroid","description":"Advanced Multi-Featured Telegram UserBot, Built in Python Using Telethon lib.","archived":false,"fork":false,"pushed_at":"2025-04-01T19:09:24.000Z","size":11907,"stargazers_count":2855,"open_issues_count":5,"forks_count":7924,"subscribers_count":49,"default_branch":"main","last_synced_at":"2025-05-06T20:20:04.484Z","etag":null,"topics":["bot","hacktoberfest","multilanguage-support","pytgcalls","python","python3","teamultroid","telegram","telegram-bot","telegram-userbot","telegrammusicbot","telegramvc","telethon","ultroid","userbot"],"latest_commit_sha":null,"homepage":"https://ultroid.tech","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TeamUltroid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"TeamUltroid"}},"created_at":"2021-02-22T00:45:41.000Z","updated_at":"2025-05-04T09:35:05.000Z","dependencies_parsed_at":"2023-02-16T10:15:56.328Z","dependency_job_id":"234c3096-a7d2-4f66-8f20-090830c77be0","html_url":"https://github.com/TeamUltroid/Ultroid","commit_stats":{"total_commits":152,"total_committers":41,"mean_commits":3.707317073170732,"dds":0.8092105263157895,"last_synced_commit":"d145554b470e7aff0806e855130fc2a44300f59b"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamUltroid%2FUltroid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamUltroid%2FUltroid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamUltroid%2FUltroid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamUltroid%2FUltroid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TeamUltroid","download_url":"https://codeload.github.com/TeamUltroid/Ultroid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254027949,"owners_count":22002140,"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":["bot","hacktoberfest","multilanguage-support","pytgcalls","python","python3","teamultroid","telegram","telegram-bot","telegram-userbot","telegrammusicbot","telegramvc","telethon","ultroid","userbot"],"created_at":"2024-09-24T20:29:34.612Z","updated_at":"2025-05-13T21:03:19.471Z","avatar_url":"https://github.com/TeamUltroid.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./resources/extras/logo_readme.jpg\" alt=\"TeamUltroid Logo\"\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\n  \u003cb\u003eUltroid - UserBot\u003c/b\u003e\n\u003c/h1\u003e\n\n\u003cb\u003eA stable pluggable Telegram userbot + Voice \u0026 Video Call music bot, based on Telethon.\u003c/b\u003e\n\n[![](https://img.shields.io/badge/Ultroid-v0.8-crimson)](#)\n[![Stars](https://img.shields.io/github/stars/TeamUltroid/Ultroid?style=flat-square\u0026color=yellow)](https://github.com/TeamUltroid/Ultroid/stargazers)\n[![Forks](https://img.shields.io/github/forks/TeamUltroid/Ultroid?style=flat-square\u0026color=orange)](https://github.com/TeamUltroid/Ultroid/fork)\n[![Size](https://img.shields.io/github/repo-size/TeamUltroid/Ultroid?style=flat-square\u0026color=green)](https://github.com/TeamUltroid/Ultroid/)   \n[![Python](https://img.shields.io/badge/Python-v3.10.3-blue)](https://www.python.org/)\n[![CodeFactor](https://www.codefactor.io/repository/github/teamultroid/ultroid/badge/main)](https://www.codefactor.io/repository/github/teamultroid/ultroid/overview/main)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/TeamUltroid/Ultroid/graphs/commit-activity)\n[![Docker Pulls](https://img.shields.io/docker/pulls/theteamultroid/ultroid?style=flat-square)](https://img.shields.io/docker/pulls/theteamultroid/ultroid?style=flat-square)   \n[![Open Source Love svg2](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/TeamUltroid/Ultroid)\n[![Contributors](https://img.shields.io/github/contributors/TeamUltroid/Ultroid?style=flat-square\u0026color=green)](https://github.com/TeamUltroid/Ultroid/graphs/contributors)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)\n[![License](https://img.shields.io/badge/License-AGPL-blue)](https://github.com/TeamUltroid/Ultroid/blob/main/LICENSE)   \n[![Sparkline](https://stars.medv.io/Teamultroid/Ultroid.svg)](https://stars.medv.io/TeamUltroid/Ultroid)\n----\n\n# Deploy\n- [Heroku](#deploy-to-heroku)\n- [Okteto](#deploy-to-okteto)\n- [Local Machine](#deploy-locally)\n\n# Documentation \n[![Documentation](https://img.shields.io/badge/Documentation-Ultroid-blue)](http://ultroid.tech/)\n\n# Tutorial \n- Full Tutorial - [![Full Tutorial](https://img.shields.io/badge/Watch%20Now-blue)](https://www.youtube.com/watch?v=0wAV7pUzhDQ)\n\n- Tutorial to get Redis URL and password - [here.](./resources/extras/redistut.md)\n---\n\n## Deploy to Heroku\nGet the [Necessary Variables](#Necessary-Variables) and then click the button below!  \n\n\u003csummary\u003eDeploy To Heroku\u003c/summary\u003e\n\u003cp\u003e\n\u003cbr\u003e\n\u003ca href=\"https://heroku.com/deploy\"\u003e\n  \u003cimg src=\"https://www.herokucdn.com/deploy/button.svg\" alt=\"Deploy\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n## Deploy to Okteto\nGet the [Necessary Variables](#Necessary-Variables) and then click the button below!\n\n[![Develop on Okteto](https://okteto.com/develop-okteto.svg)](https://cloud.okteto.com/deploy?repository=https://github.com/TeamUltroid/Ultroid)\n\n## Deploy Locally\n- [Traditional Method](#local-deploy---traditional-method)\n- [Easy Method](#local-deploy---easy-method)\n- [Ultroid CLI](#ultroid-cli)\n\n### Local Deploy - Easy Method\n- Linux - `wget -O locals.py https://git.io/JY9UM \u0026\u0026 python3 locals.py`\n- Windows - `cd desktop ; wget https://git.io/JY9UM -o locals.py ; python locals.py`\n- Termux - `wget -O install-termux https://tiny.ultroid.tech/termux \u0026\u0026 bash install-termux`\n\n### Local Deploy - Traditional Method\n- Get your [Necessary Variables](#Necessary-Variables)\n- Clone the repository:    \n`git clone https://github.com/TeamUltroid/Ultroid.git`\n- Go to the cloned folder:    \n`cd Ultroid`\n- Create a virtual env:      \n`virtualenv -p /usr/bin/python3 venv`\n`. ./venv/bin/activate`\n- Install the requirements:      \n`pip(3) install -U -r re*/st*/optional-requirements.txt`\n`pip(3) install -U -r requirements.txt`\n- Generate your `SESSION`:\n  - For Linux users:\n    `bash sessiongen`\n     or\n    `wget -O session.py https://git.io/JY9JI \u0026\u0026 python3 session.py`\n  - For Termux users:\n    `wget -O session.py https://git.io/JY9JI \u0026\u0026 python session.py`\n  - For Windows Users:\n    `cd desktop ; wget https://git.io/JY9JI -o ultroid.py ; python ultroid.py`\n- Fill your details in a `.env` file, as given in [`.env.sample`](https://github.com/TeamUltroid/Ultroid/blob/main/.env.sample).\n(You can either edit and rename the file or make a new file named `.env`.)\n- Run the bot:\n  - Linux Users:\n   `bash startup`\n  - Windows Users:\n    `python(3) -m pyUltroid`\n\n---\n## Necessary Variables\n- `SESSION` - SessionString for your accounts login session. Get it from [here](#Session-String)\n\nOne of the following database:\n- For **Redis** (tutorial [here](./resources/extras/redistut.md))\n  - `REDIS_URI` - Redis endpoint URL, from [redislabs](http://redislabs.com/).\n  - `REDIS_PASSWORD` - Redis endpoint Password, from [redislabs](http://redislabs.com/).\n- For **MONGODB**\n  - `MONGO_URI` - Get it from [mongodb](https://mongodb.com/atlas).\n- For **SQLDB**\n  - `DATABASE_URL`- Get it from [elephantsql](https://elephantsql.com).\n\n## Session String\nDifferent ways to get your `SESSION`:\n* [![Run on Repl.it](https://replit.com/badge/github/TeamUltroid/Ultroid)](https://replit.com/@TeamUltroid/UltroidStringSession)\n* Linux : `wget -O session.py https://git.io/JY9JI \u0026\u0026 python3 session.py`\n* PowerShell : `cd desktop ; wget https://git.io/JY9JI ; python ultroid.py`\n* Termux : `wget -O session.py https://git.io/JY9JI \u0026\u0026 python session.py`\n* TelegramBot : [@SessionGeneratorBot](https://t.me/SessionGeneratorBot)\n\n---\n\n# License\n[![License](https://www.gnu.org/graphics/agplv3-155x51.png)](LICENSE)   \nUltroid is licensed under [GNU Affero General Public License](https://www.gnu.org/licenses/agpl-3.0.en.html) v3 or later.\n\n---\n\n# Credits\n* [![TeamUltroid-Devs](https://img.shields.io/static/v1?label=Teamultroid\u0026message=devs\u0026color=critical)](https://t.me/UltroidDevs)\n* [Lonami](https://github.com/LonamiWebs/) for [Telethon.](https://github.com/LonamiWebs/Telethon)\n* [MarshalX](https://github.com/MarshalX) for [PyTgCalls.](https://github.com/MarshalX/tgcalls)\n\n\u003e Made with 💕 by [@TeamUltroid](https://t.me/TeamUltroid).    \n","funding_links":["https://github.com/sponsors/TeamUltroid"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamultroid%2Fultroid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteamultroid%2Fultroid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamultroid%2Fultroid/lists"}