{"id":20146251,"url":"https://github.com/mohammadrezaamani/uniland","last_synced_at":"2025-06-19T05:41:37.522Z","repository":{"id":151984907,"uuid":"562096973","full_name":"MohammadrezaAmani/UniLand","owner":"MohammadrezaAmani","description":"A highly modular and diverse Telegram Bot for universities and institutions written in python. This is the effort of a group of eight CS students at AUT as the final project for Software Engineering Course (1380044).","archived":false,"fork":false,"pushed_at":"2025-02-17T14:20:07.000Z","size":876,"stargazers_count":19,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-23T21:11:50.145Z","etag":null,"topics":["orm","pyrogram","python","sqlalchemy","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/UniLandbot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MohammadrezaAmani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-11-05T09:54:28.000Z","updated_at":"2025-02-26T13:57:37.000Z","dependencies_parsed_at":"2023-11-12T22:29:16.029Z","dependency_job_id":"adb094fb-7d51-411a-aeea-58141a7ee63c","html_url":"https://github.com/MohammadrezaAmani/UniLand","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FUniLand","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FUniLand/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FUniLand/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FUniLand/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MohammadrezaAmani","download_url":"https://codeload.github.com/MohammadrezaAmani/UniLand/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248095517,"owners_count":21046862,"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":["orm","pyrogram","python","sqlalchemy","telegram","telegram-bot"],"created_at":"2024-11-13T22:20:45.458Z","updated_at":"2025-04-09T19:22:20.477Z","avatar_url":"https://github.com/MohammadrezaAmani.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca\u003e\n        \u003cimg src=\"./assets/bot_logo.png\" alt=\"UniLand\" width=\"256\"\u003e\n    \u003c/a\u003e\n    \u003cbr\u003e\n    \u003cb\u003eHighly Modular and Diverse Telegram Bot\u003c/b\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://t.me/UniLandbot\"\u003e\n        Bot\n    \u003c/a\u003e\n    •\n    \u003ca href=\"\"\u003e\n        Documentation\n    \u003c/a\u003e\n    •\n    \u003ca href=\"https://t.me/UniLand_AUT\"\u003e\n        Channel\n    \u003c/a\u003e\n    •\n    \u003ca href=\"https://t.me/UniLandSupport\"\u003e\n        Support\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n# UniLand Telegram Bot\n\u003e *An instance of this bot is active at [UniLand Telegram Bot](https://t.me/UniLandbot \"UniLand Bot\")*  \n\nA highly modular and diverse Telegram Bot for universities and institutions written in python. This is the effort of a group of eight CS students at [AUT](https://math.aut.ac.ir/index.php?sid=7\u0026slc_lang=en \"Amirkabir University of Technology\") as the final project for Software Engineering Course *(1380044)*.\n\n\n\n\n## \u003ca name='Contents'\u003e\u003c/a\u003eContents\n\u003c!-- vscode-markdown-toc --\u003e\n* [Requirements](#Requirements)\n\t* [Python Compatibility](#Python-Compatibility)\n\t* [Dependencies](#Dependencies)\n* [Instructions](#Instructions)\n* [Key Features](#Key-Features)\n* [License](#License)\n\n\u003c!-- vscode-markdown-toc-config\n\tnumbering=false\n\tautoSave=true\n\t/vscode-markdown-toc-config --\u003e\n\u003c!-- /vscode-markdown-toc --\u003e\n\n\n## \u003ca name='Requirements'\u003e\u003c/a\u003eRequirements\n### \u003ca name='Python-Compatibility'\u003e\u003c/a\u003e**Python Compatibility**\nThis bot is written entirely in python. tested versions are `python 3.11, 3.10, 3.9, 3.8, 3.7` while older versions should not cause any problem, we recommend using the latest version of `python3`.\n\n### \u003ca name='Dependencies'\u003e\u003c/a\u003e**Dependencies**\nThis package requires the following packages:\n* [pyrogram](https://github.com/pyrogram/pyrogram \"Pyrogram Github\") - Telegram MTProto API\n* [SQLAlchemy](https://github.com/sqlalchemy/sqlalchemy \"SQLAlchemy Github\") - SQL \u0026 ORM Toolkit\n* [uvloop](https://github.com/MagicStack/uvloop \"uvloop Github\") - Asynchronus Programming\n* [TgCrypto](https://github.com/pyrogram/tgcrypto \"TgCrypto Github\") - Secure Encryption for Telegram Protocols\n\n## \u003ca name='Instructions'\u003e\u003c/a\u003eInstructions\nTo run the bot, you need to have a Telegram API ID and API Hash. You can get them from [my.telegram.org](https://my.telegram.org \"Telegram API\"). Then, you need to create a `config.py` file in the root directory of the project and fill it with the following information:\n\n```python\n     API_ID = # Your API ID\n     API_HASH = # Your API Hash\n     BOT_TOKEN = # Your Bot Token\n     REPL_URL = # Your Replit URL\n```\n\u003e ~~We recommend using a [Repl](https://replit.com/ \"Replit\") to host the bot but if you have your own server, replace `REPL_URL` with its URL.~~\n\u003e\n\u003e *[Replit](https://replit.com/) no longer supports Telegram bots, use another vps or hosting service.*\n\nThen, you can run the bot using the following command:\n\n```bash\n    python3 -m uniland\n```\n\n## \u003ca name='Key-Features'\u003e\u003c/a\u003eKey Features\nSome of the key feature are listed below. For more information, please refer to the Documentation.\n* **Modular** - Highly modular and can be easily extended.\n* **Easy to Use** - Easy to customize the interface and messages.\n* **Diverse** - Can be used for a wide range of purposes.\n* **Secure** - Uses the latest encryption protocols matched by Telegram's MTProto.\n* **Fast** - Build with the fastest performing asynchronus libraries to achieve high performance.\n\n## \u003ca name='License'\u003e\u003c/a\u003eLicense\nDistributed under the MIT License. See `LICENSE` for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohammadrezaamani%2Funiland","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohammadrezaamani%2Funiland","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohammadrezaamani%2Funiland/lists"}