Click Here To Access HyperTAG Bot on Telegram
HyperTAG is a Telegram bot that leverages advanced AI models to generate context-aware tags and summaries for your messages. It can also automatically create tags and summaries for channel posts.
The bot analyzes the text content of your messages along with any included links, producing relevant tags and summaries based on both the message text and the text from the links. Additionally, it generates summaries for Web pages or YouTube videos using their links.
Usage Example: (more examples below)
Expand to See More Usage Examples: ➡️
- Generating Tag from a Text
- Generating Tag and Summary from a Regular Url
- Generating Tag and Summary from a YouTube Url
- Generating Tag and Summary from a YouTube Url (Expanded)
Interested in trying it out? Click Here to access the bot, or simply search for @HyperTAG_bot on Telegram.
To see HyperTAG's channel integration features in action (automated tag and summary generation for channel posts), check out the @HW_HUB channel on Telegram.
Join my Devlog channel on Telegram for updates and announcements about HyperTAG and other projects.
-
📖 Text Analysis: HyperTAG analyzes the text content of your messages to recommend relevant tags.
-
🔗 Link Analysis: When your message contains links, HyperTAG extracts the main content (up to the first 2 URLs) to enhance tag recommendations.
-
🎥 YouTube Analysis: HyperTAG also retrieves captions from YouTube video links to use it in generating better tags.
-
📝 Summarization: HyperTAG can summarize the First Link in a message—whether it's a regular or YouTube link—providing a concise overview of the content as a brief summary.
-
📢 Channel Integration: You can add HyperTAG to your channels, enabling it to automatically generate tags and, if enabled, summaries for your posts.
... and more!
To run HyperTAG locally, ensure you have the following:
- Node.js v18
- HyperTAG requires Node.js version 18 LTS (Download Link) for compatibility, as newer Node.js versions introduce breaking changes that affect some libraries used in the project. If you have a different Node.js version installed and prefer not to uninstall it, you can manage multiple versions and switch between them using a Node Version Manager (Windows Guide - Mac/Linux Guide).
- Telegram API Key
- Create a bot using @BotFather on Telegram and obtain the API key. For detailed instructions, refer to the HyperTAG Bot Setup Guide documentation.
- Google Gemini API Key
- Sign up at Google AI Studio and generate your free Gemini API key.
Both the Telegram and Gemini API keys are mandatory for the bot to function, and they are free to obtain without needing a credit card.
To set up HyperTAG for the first time, follow the steps below. If you are upgrading from a previous version, please refer to the Upgrade Guide for detailed instructions on updating your instance safely.
-
Clone the repository:
git clone https://github.com/mostafa-abbasi/HyperTAG.git cd HyperTAG
-
Install dependencies:
npm install
-
Create Configuration File:
cp config.env.example config.env
- This command creates a new
config.env
file in the project's root directory and copies the contents ofconfig.env.example
into it.
- Set Up Environment Variables:
- open the newly created
config.env
file and fill in the required environment variables (TELEGRAM_API_KEY
andGEMINI_API_KEY
). Refer to the Prerequisites section for instructions on obtaining the keys.
-
Run the bot:
npm start
If you're running/hosting an older version of HyperTAG and would like to upgrade to the latest release, please refer to the HyperTAG Upgrade Guide. This guide provides step-by-step instructions to ensure a smooth transition without losing your current configurations or data.
After completing Step 4 of the installation, please take a moment to review the config.env
file thoroughly. If you haven't done this installation step yet, refer to the config.env.example file, which serves as a baseline for your config.env
.
Note: You don't have to change all of the options below to start/use the bot, the necessary ones are only Telegram & Gemini API keys.
This file contains a variety of customizable options that can significantly enhance your experience with HyperTAG. While certain settings, such as API keys for Telegram and Gemini, are mandatory, many others are optional and can greatly influence the bot's functionality. We encourage you to adjust these settings according to your preferences to optimize your hosting experience with HyperTAG.
Key | Description | Required? |
---|---|---|
TELEGRAM_API_KEY |
API key for interacting with Telegram bot. | Yes |
GEMINI_API_KEYS |
Google Gemini API keys/keys for generating tags and summaries | Yes |
Variable | Description | Default |
---|---|---|
NODE_ENV |
Set to production for deployment. |
development |
POLLING_INTERVAL_DEV |
Polling interval in development (ms). | 1000 |
POLLING_INTERVAL_PROD |
Polling interval in production (ms). | 3000 |
Variable | Description | Default |
---|---|---|
TAG_GENERATION_METHOD |
Select tag generation method (1 -4 ). |
1 (Gemini API) |
Methods | Description | API Key Required? | Maximum Free Daily Limit |
---|---|---|---|
1 or googleGeminiTagGenerator() |
Works by using google gemini's API Endpoint, fast, accurate, high rate-limit | Yes | 1500 (Gemini-Flash) |
2 or openAiCompatibleTagGenerator() |
Works by sending the request to a provider that has OpenAi-Compatible API (e.g. OpenRouter) | Yes | 200 (Any Free Model on OpenRouter) |
3 or ollamaTagGenerator() |
Works by using a local-hosted LLM through Ollama | No | Unlimited |
4 or textRazorTagGenerator() |
Works by using text Razor's API Endpoint, fast, semi-accurate, medium rate-limit | Yes | 500 |
Key | Description | Required for |
---|---|---|
OPENROUTER_API_KEYS |
OpenRouter API key/keys. | Method 2 |
TEXTRAZOR_API_KEYS |
TextRazor API key/keys. | Method 4 |
Variable | Description | Default |
---|---|---|
ENABLE_SUMMARIZATION |
Enable/disable URL summarization. | true |
SUMMARIZATION_METHOD |
Select summarization method (1 -3 ). |
1 (Gemini API) |
Methods | Description | API Key Required? | Maximum Free Daily Limit |
---|---|---|---|
1 or googleGeminiSummaryGenerator() |
Works by using google gemini's API Endpoint, fast, accurate, high rate-limit | Yes | 1500 (Gemini-Flash) |
2 or openAiCompatibleSummaryGenerator() |
Works by sending the request to a provider that has OpenAi-Compatible API (e.g. OpenRouter) | Yes | 200 (Any Free Model on OpenRouter) |
3 or ollamaSummaryGenerator() |
Works by using a local-hosted LLM through Ollama | No | Unlimited |
Variable | Description | Default |
---|---|---|
PROXY_BASE_URL |
Cloudflare worker URL for proxy requests. | N/A |
ENABLE_URL_PROXY |
Enable proxy for failed URLs. | false |
ENABLE_TELEGRAM_PROXY |
Use proxy for Telegram API requests. | false |
ENABLE_GEMINI_PROXY |
Use proxy for Gemini API requests. | false |
ENABLE_OPENROUTER_PROXY |
Use proxy for OpenRouter API requests. | false |
ENABLE_TEXTRAZOR_PROXY |
Use proxy for TextRazor API requests. | false |
Variable | Description | Default |
---|---|---|
BOT_ADMIN_USER_ID |
Telegram ID of the bot admin (optional). | N/A |
VIP_USER_IDS |
List of Telegram IDs for VIP users (optional). | N/A |
Variable | Description | Default |
---|---|---|
MAX_CONNECTED_CHANNELS |
Max channels for regular users. | 1 |
MAX_CONNECTED_CHANNELS_VIP |
Max channels for VIP users. | 5 |
Variable | Description | Default |
---|---|---|
RATE_LIMIT_PRIVATE_DEV |
Rate limit in development (requests/day). | 10 |
RATE_LIMIT_PRIVATE_PROD |
Rate limit in production (requests/day). | 10 |
RATE_LIMIT_PRIVATE_VIP_DEV |
VIP rate limit in development (requests/day). | 100 |
RATE_LIMIT_PRIVATE_VIP_PROD |
VIP rate limit in production (requests/day). | 50 |
Variable | Description | Default |
---|---|---|
RATE_LIMIT_CHANNEL_DEV |
Rate limit in development (requests/day). | 10 |
RATE_LIMIT_CHANNEL_PROD |
Rate limit in production (requests/day). | 10 |
RATE_LIMIT_CHANNEL_VIP_DEV |
VIP rate limit in development (requests/day). | 100 |
RATE_LIMIT_CHANNEL_VIP_PROD |
VIP rate limit in production (requests/day). | 25 |
Variable | Description | Default |
---|---|---|
ENABLE_TRANSLATION |
Enable translation feature. | true |
ENABLE_SECONDARY_CONTEXT_EXTENSION |
Enable fallback context extension | true |
NUMBER_OF_TAGS_TO_DISPLAY_IN_PRIVATE_CHAT |
Tags to display in private chats. | 10 |
NUMBER_OF_TAGS_TO_DISPLAY_IN_CHANNEL |
Tags to display in channels. | 5 |
NUMBER_OF_URLS_TO_ANALYZE_FROM_EACH_REQUEST |
URLs to fetch for analysis. | 2 |
NUMBER_OF_CHARACTERS_TO_RETRIEVE_FROM_EACH_URL |
Characters to retrieve. | 15000 |
MAX_URL_SIZE |
Maximum URL size in bytes (e.g., 10MB). | 10485760 |
Variable | Description | Example |
---|---|---|
SUPPORT_ACCOUNT_HANDLE |
Telegram handle for support. | @mostafa_abbac |
BOT_NAME |
Name of the bot. | HyperTAG |
BOT_HANDLE |
Telegram handle of the bot. | @HyperTAG_bot |
BOT_LINK |
Direct link to the bot. | t.me/HyperTAG_bot |
BOT_SIGNATURE |
Text at the end of messages edited by HyperTAG. | @HyprTAG |
BOT_SUPPORT_CHANNEL |
Direct link to the bot's support channel | t.me/Falken_Devlog |
BOT_GITHUB_LINK |
Direct link to the bot's repository link | github.com/Mostafa-Abbasi/HyperTAG |
Variable | Description | Example |
---|---|---|
ENABLE_SPONSOR_CHANNEL |
Enable mandatory sponsor channel for users. | true |
SPONSOR_CHANNEL_ID |
Telegram channel ID to join before using the bot. | -1001374364132 |
SPONSOR_CHANNEL_LINK |
Direct link/handle for sponsor channel. | t.me/+0ifSLk5nQJ43ODY8 |
HyperTAG provides an optional proxy feature aimed at improving accessibility and privacy, especially in areas with internet censorship (such as Iran) or where access to specific services is limited. This feature routes requests through a Cloudflare Worker, enabling users to circumvent regional restrictions while concealing their IP address and location. It's important to note that there shouldn't be any issues when accessing Cloudflare itself by the host.
The proxy can be used for various services within the bot that perform direct HTTP/HTTPS requests, effectively acting as a bridge between the client and the target URL.
To activate the proxy feature, please refer to the comprehensive instructions in the Cloudflare Worker Proxy Setup Guide. This guide will assist you in configuring the config.env
file to ensure that both API requests and URL fetching are routed through the proxy.
Contributions are welcomed! If you have ideas or want to improve the bot, feel free to submit a pull request or create an issue.
You can contact me at mostafaabbac@gmail.com or @mostafa_abbac on Telegram.
This project is licensed under the MIT License. See the LICENSE file for details.