|
1 | | -<a href="https://www.codacy.com/gh/coddrago/Heroku/dashboard?utm_source=github.com&utm_medium=referral&utm_content=coddrago/Heroku&utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/97e3ea868f9344a5aa6e4d874f83db14"/></a> |
2 | | -<a href="#"><img src="https://img.shields.io/github/languages/code-size/coddrago/Heroku"/></a> |
3 | | -<a href="#"><img src="https://img.shields.io/github/issues-raw/coddrago/Heroku"/></a> |
4 | | -<a href="#"><img src="https://img.shields.io/github/license/coddrago/Heroku"/></a> |
5 | | -<a href="#"><img src="https://img.shields.io/github/commit-activity/m/coddrago/Heroku"/></a><br> |
6 | | -<a href="#"><img src="https://img.shields.io/github/forks/coddrago/Heroku?style=flat"/></a> |
7 | | -<a href="#"><img src="https://img.shields.io/github/stars/coddrago/Heroku"/></a> <a href="https://github.com/psf/black"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code style: black"></a><br> |
| 1 | +<div align="center"> |
| 2 | + <img src="https://github.com/hikariatama/assets/raw/master/1326-command-window-line-flat.webp" height="80"> |
| 3 | + <h1>Heroku Userbot</h1> |
| 4 | + <p>Advanced Telegram userbot with enhanced security and modern features</p> |
| 5 | + |
| 6 | + <p> |
| 7 | + <a href="https://www.codacy.com/gh/coddrago/Heroku/dashboard?utm_source=github.com&utm_medium=referral&utm_content=coddrago/Heroku&utm_campaign=Badge_Grade"> |
| 8 | + <img src="https://app.codacy.com/project/badge/Grade/97e3ea868f9344a5aa6e4d874f83db14" alt="Codacy Grade"> |
| 9 | + </a> |
| 10 | + <a href="#"> |
| 11 | + <img src="https://img.shields.io/github/languages/code-size/coddrago/Heroku" alt="Code Size"> |
| 12 | + </a> |
| 13 | + <a href="#"> |
| 14 | + <img src="https://img.shields.io/github/issues-raw/coddrago/Heroku" alt="Open Issues"> |
| 15 | + </a> |
| 16 | + <a href="#"> |
| 17 | + <img src="https://img.shields.io/github/license/coddrago/Heroku" alt="License"> |
| 18 | + </a> |
| 19 | + <a href="#"> |
| 20 | + <img src="https://img.shields.io/github/commit-activity/m/coddrago/Heroku" alt="Commit Activity"> |
| 21 | + </a> |
| 22 | + <br> |
| 23 | + <a href="#"> |
| 24 | + <img src="https://img.shields.io/github/forks/coddrago/Heroku?style=flat" alt="Forks"> |
| 25 | + </a> |
| 26 | + <a href="#"> |
| 27 | + <img src="https://img.shields.io/github/stars/coddrago/Heroku" alt="Stars"> |
| 28 | + </a> |
| 29 | + <a href="https://github.com/psf/black"> |
| 30 | + <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black"> |
| 31 | + </a> |
| 32 | + </p> |
| 33 | +</div> |
| 34 | + |
| 35 | +--- |
| 36 | + |
| 37 | +## ⚠️ Security Notice |
| 38 | + |
| 39 | +> **Important Security Advisory** |
| 40 | +> While Heroku implements extended security measures, installing modules from untrusted developers may still cause damage to your server/account. |
| 41 | +> |
| 42 | +> **Recommendations:** |
| 43 | +> - ✅ Download modules exclusively from official repositories or trusted developers |
| 44 | +> - ❌ Do NOT install modules if unsure about their safety |
| 45 | +> - ⚠️ Exercise caution with unknown commands (`.terminal`, `.eval`, `.ecpp`, etc.) |
| 46 | +
|
| 47 | +--- |
| 48 | + |
| 49 | +## 🚀 Installation |
| 50 | + |
| 51 | +### Manual Installation (VPS/VDS Server) |
| 52 | + |
| 53 | +```bash |
| 54 | +apt update && apt install git python3 -y && \ |
| 55 | +git clone https://github.com/coddrago/Heroku && \ |
| 56 | +cd Heroku && \ |
| 57 | +pip install -r requirements.txt && \ |
| 58 | +python3 -m heroku |
| 59 | +``` |
| 60 | + |
| 61 | +> **Note for VPS/VDS Users:** |
| 62 | +> Add `--proxy-pass` to enable SSH tunneling |
| 63 | +> Add `--no-web` for console-only setup |
| 64 | +> Add `--root` for root users (to avoid entering force_insecure) |
| 65 | +
|
| 66 | +### Additional Features |
8 | 67 |
|
9 | | -### Disclaimer |
| 68 | +<details> |
| 69 | + <summary><b>🔒 Automatic Database Backuper</b></summary> |
| 70 | + <img src="https://user-images.githubusercontent.com/36935426/202905566-964d2904-f3ce-4a14-8f05-0e7840e1b306.png" width="400"> |
| 71 | +</details> |
10 | 72 |
|
11 | | -> Even though Heroku has extended security measures for scam-modules protection, flood-based account restrictions protection and others, it still may cause damage to server / account if you install module from untrusted developer. Please, consider downloading modules exceptionally from official repository or from trusted developers. If you are not sure about whether module is safe or not, please, DO NOT INSTALL IT. Same goes for unknown commands (.terminal, .e, .eval, .ec, .ecpp, etc.). You have been warned. |
| 73 | +<details> |
| 74 | + <summary><b>👋 Welcome Installation Screens</b></summary> |
| 75 | + <img src="https://user-images.githubusercontent.com/36935426/202905720-6319993b-697c-4b09-a194-209c110c79fd.png" width="300"> |
| 76 | + <img src="https://user-images.githubusercontent.com/36935426/202905746-2a511129-0208-4581-bb27-7539bd7b53c9.png" width="300"> |
| 77 | +</details> |
12 | 78 |
|
13 | | -<hr> |
14 | | -<h2><img src="https://github.com/hikariatama/assets/raw/master/1326-command-window-line-flat.webp" height="54" align="middle"> Installation</h2> |
| 79 | +--- |
15 | 80 |
|
16 | | -### Installation page |
| 81 | +## ✨ Key Features & Improvements |
17 | 82 |
|
18 | | -<img src="https://github.com/hikariatama/assets/raw/master/install_qr.gif" height="256"> |
| 83 | +| Feature | Description | |
| 84 | +|---------|-------------| |
| 85 | +| 🆕 **Latest Telegram Layer** | Support for forums and newest Telegram features | |
| 86 | +| 🔒 **Enhanced Security** | Native entity caching and targeted security rules | |
| 87 | +| 🎨 **UI/UX Improvements** | Modern interface and user experience | |
| 88 | +| 📦 **Core Modules** | Improved and new core functionality | |
| 89 | +| ⏱ **Rapid Bug Fixes** | Faster resolution than FTG/GeekTG | |
| 90 | +| 🔄 **Backward Compatibility** | Works with FTG, GeekTG and Hikka modules | |
| 91 | +| ▶️ **Inline Elements** | Forms, galleries and lists support | |
19 | 92 |
|
| 93 | +--- |
20 | 94 |
|
21 | | -<b>Manual installation (no script):</b><br> |
22 | | -<code>apt update && apt install git python3 -y && git clone https://github.com/coddrago/Heroku && cd Heroku && pip install -r requirements.txt && python3 -m hikka</code><br.> |
23 | | -<i>If you are on VPS\VDS, type <code>--proxy-pass</code> in the end of command to open SSH tunnel to your Heroku web interface, or use <code>--no-web</code> to complete setup in console</i><br> |
24 | | -<br> |
25 | | -<b>Some further details:</b> |
| 95 | +## 📋 Requirements |
26 | 96 |
|
27 | | -<details> |
28 | | - <summary>Pre-installed automatic database backuper</summary> |
29 | | - <img src="https://user-images.githubusercontent.com/36935426/202905566-964d2904-f3ce-4a14-8f05-0e7840e1b306.png" width="300"> |
30 | | -</details> |
31 | | -<details> |
32 | | - <summary>Welcome installation info</summary> |
33 | | - <img src="https://user-images.githubusercontent.com/36935426/202905720-6319993b-697c-4b09-a194-209c110c79fd.png" width="300"> |
34 | | - <img src="https://user-images.githubusercontent.com/36935426/202905746-2a511129-0208-4581-bb27-7539bd7b53c9.png" width="300"> |
35 | | -</details> |
| 97 | +- **Python 3.9-3.13** |
| 98 | +- **API Credentials** from [Telegram Apps](https://my.telegram.org/apps) |
| 99 | + |
| 100 | +--- |
| 101 | + |
| 102 | +## 📚 Documentation |
| 103 | + |
| 104 | +| Type | Link | |
| 105 | +|------|------| |
| 106 | +| **User Documentation** | [heroku-ub.xyz](https://heroku-ub.xyz/) | |
| 107 | +| **Developer Docs** | [dev.heroku-ub.xyz](https://dev.heroku-ub.xyz/) | |
| 108 | + |
| 109 | +--- |
| 110 | + |
| 111 | +## 💬 Support |
| 112 | + |
| 113 | +[](https://t.me/heroku_talks) |
| 114 | + |
| 115 | +--- |
| 116 | + |
| 117 | +## ⚠️ Usage Disclaimer |
| 118 | + |
| 119 | +> This project is provided as-is. The developer takes **NO responsibility** for: |
| 120 | +> - Account bans or restrictions |
| 121 | +> - Message deletions by Telegram |
| 122 | +> - Security issues from scam modules |
| 123 | +> - Session leaks from malicious modules |
| 124 | +> |
| 125 | +> **Security Recommendations:** |
| 126 | +> - Enable `.api_fw_protection` |
| 127 | +> - Avoid installing many modules at once |
| 128 | +> - Review [Telegram's Terms](https://core.telegram.org/api/terms) |
| 129 | +
|
| 130 | +--- |
| 131 | + |
| 132 | +## 🙏 Acknowledgements |
36 | 133 |
|
37 | | -<hr> |
38 | | -<h2><img src="https://github.com/hikariatama/assets/raw/master/35-edit-flat.webp" height="54" align="middle"> Changes</h2> |
39 | | - |
40 | | -<ul> |
41 | | - <li>🆕 <b>Latest Telegram layer</b> with reactions, video stickers and other stuff</li> |
42 | | - <li>🔓 <b>Security</b> improvements, including <b>native entity caching</b> and <b>targeted security rules</b></li> |
43 | | - <li>🎨 <b>UI/UX</b> improvements</li> |
44 | | - <li>📼 Improved and new <b>core modules</b></li> |
45 | | - <li>⏱ Quick <b>bug fixes</b> (compared to official FTG and GeekTG)</li> |
46 | | - <li>▶️ <b>Inline forms, galleries and lists</b></li> |
47 | | - <li>🔁 Full <b>backward compatibility</b> with FTG, GeekTG and Hikka modules</li> |
48 | | -</ul> |
49 | | -<hr> |
50 | | -<h2 border="none"><img src="https://github.com/hikariatama/assets/raw/master/1312-micro-sd-card-flat.webp" height="54" align="middle"> Requirements</h2> |
51 | | -<ul> |
52 | | - <li>Python 3.9-3.13</li> |
53 | | - <li>API_ID and HASH from <a href="https://my.telegram.org/apps" color="#2594cb">Telegram</a></li> |
54 | | -</ul> |
55 | | -<hr> |
56 | | -<h2 border="none"><img src="https://github.com/hikariatama/assets/raw/master/680-it-developer-flat.webp" height="54" align="middle"> Documentation</h2> |
57 | | - |
58 | | -Check out <a href="https://heroku-ub.xyz/">heroku-ub.xyz</a> for users' documentation<br> |
59 | | -And <a href="https://dev.heroku-ub.xyz/">dev.heroku-ub.xyz</a> for developers documentation |
60 | | - |
61 | | -<hr> |
62 | | -<h2 border="none"><img src="https://github.com/hikariatama/assets/raw/master/981-consultation-flat.webp" height="54" align="middle"> <a href="https://t.me/heroku_talks">Support</a></h2> |
63 | | -<hr> |
64 | | -<h2 border="none"><img src="https://github.com/hikariatama/assets/raw/master/541-hand-washing-step-12-flat.webp" height="54" align="middle"> Features</h2> |
65 | | -<table> |
66 | | - <tr> |
67 | | - <td> |
68 | | - <img src="https://github.com/hikariatama/assets/raw/master/1286-three-3-key-flat.webp" height="32" align="middle"><b> Forms - bored of writing? Use buttons!</b> |
69 | | - </td> |
70 | | - <td> |
71 | | - <img src="https://github.com/hikariatama/assets/raw/master/61-camera-flat.webp" height="32" align="middle"><b> Galleries - scroll your favorite photos in Telegram</b> |
72 | | - </td> |
73 | | - </tr> |
74 | | - <tr> |
75 | | - <td> |
76 | | - <img src="https://user-images.githubusercontent.com/36935426/202842205-9a3906f8-37b1-47f4-acd1-ae441f84aeab.gif"> |
77 | | - </td> |
78 | | - <td> |
79 | | - <img src="https://user-images.githubusercontent.com/36935426/202842215-b7bddaf2-f544-4823-80b4-5c2cccaf2157.gif"> |
80 | | - </td> |
81 | | - </tr> |
82 | | -</table> |
83 | | -<table> |
84 | | - <tr> |
85 | | - <td> |
86 | | - <img src="https://github.com/hikariatama/assets/raw/master/216-arrow-5-flat.webp" height="32" align="middle"><b> Inline - share userbot with your friends</b> |
87 | | - </td> |
88 | | - <td> |
89 | | - <img src="https://github.com/hikariatama/assets/raw/master/1054-amazon-echo-speaker-flat.webp" height="32" align="middle"><b> Bot interactions - "No PM"? No problem. Feedback bot at your service</b> |
90 | | - </td> |
91 | | - </tr> |
92 | | - <tr> |
93 | | - <td> |
94 | | - <img src="https://user-images.githubusercontent.com/36935426/202842234-e53f616d-7423-4a64-a5da-fb71282ad2c4.gif"> |
95 | | - </td> |
96 | | - <td> |
97 | | - <img src="https://user-images.githubusercontent.com/36935426/160476037-9537f1c7-8b72-408f-b84c-b89825930bf5.gif"> |
98 | | - </td> |
99 | | - </tr> |
100 | | -</table> |
101 | | -<table> |
102 | | - <tr> |
103 | | - <td> |
104 | | - <img src="https://github.com/hikariatama/assets/raw/master/1140-error-flat.webp" height="32" align="middle"><b> InlineLogs - traceback directly in message, caused error</b> |
105 | | - </td> |
106 | | - <td> |
107 | | - <img src="https://github.com/hikariatama/assets/raw/master/35-edit-flat.webp" height="32" align="middle"><b> Grep - execute command and get only required lines</b> |
108 | | - </td> |
109 | | - </tr> |
110 | | - <tr> |
111 | | - <td> |
112 | | - <img src="https://user-images.githubusercontent.com/36935426/202842250-b60d218e-9df4-47f6-8c67-b2ef641b4d2d.gif"> |
113 | | - </td> |
114 | | - <td> |
115 | | - <img src="https://user-images.githubusercontent.com/36935426/202842263-ee2d5c94-3fd5-43b3-b8ac-2397b69e0fc6.gif"> |
116 | | - </td> |
117 | | - </tr> |
118 | | -</table> |
119 | | - |
120 | | -<b>👨👦 NoNick, NoNickUser, NoNickCmd, NoNickChat - use another account for userbot</b> |
121 | | -<img src="https://user-images.githubusercontent.com/36935426/202842278-37fbc518-1679-45d7-92f5-9e519275630d.png"> |
122 | | - |
123 | | -<hr> |
124 | | -<i>⚠️ This project is provided as-is. Developer doesn't take ANY responsibility over any problems, caused by userbot. By installing Heroku you take all risks on you. This is but not limited to account bans, deleted (by Telegram algorithms) messages, SCAM-modules, leaked sessions (due to SCAM-modules). It is <b>highly</b> recommended to enable the API Flood protection (.api_fw_protection) and not to install many modules at once. By using Heroku you give your consent to any actions made by your account in background in purposes of automatization. Please, consider reading https://core.telegram.org/api/terms for more information.</i> |
125 | | - |
126 | | -<b>Special thanks to:</b> |
127 | | - |
128 | | -<ul> |
129 | | - <li><a href="https://gitlab.com/hikariatama">Hikari</a> for Hikka, which is the base of project</li> |
130 | | - <li><a href="https://t.me/lonami">Lonami</a> for Telethon, which is the base of Heroku-TL</li> |
131 | | -</ul> |
| 134 | +- [**Hikari**](https://gitlab.com/hikariatama) for Hikka (project foundation) |
| 135 | +- [**Lonami**](https://t.me/lonami) for Telethon (Heroku-TL backbone) |
0 commit comments