tbdavid2019/telegram-bot-summary

By tbdavid2019

•Updated about 17 hours ago

Image

Machine learning & AI

10K+

Overview Tags

tbdavid2019/telegram-bot-summary repository overview

⁠Summary GPT Bot

An AI-powered text summarization Telegram bot that generates concise summaries of text, URLs, PDFs, and YouTube videos.

⁠新增功能

Whisper 聽寫功能：調用免費的 GROQ Whisper API，用於自動生成字幕。
無字幕處理：當影片無字幕時，可以啟用聽力辨識生成字幕。
郵件功能：自動將摘要結果發送到指定的收件人或群組郵箱（可配置 SMTP）。
使用 .env 文件簡化環境變數配置。

⁠示範帳號

Telegram bot 可濃縮文字、URL、PDF 和 YouTube 影片的重點摘要。

👉 telegram 示範機器人小濃縮⁠

⁠Features

Supports text：處理純文本。
Supports URLs：自動擷取網頁內容。
Supports PDFs：可解析 PDF 檔案。
Supports YouTube videos：處理影片字幕及聽寫。
Whisper API：自動轉錄無字幕的影片（需啟用 USE_AUDIO_FALLBACK）。
Email Summaries：自動將生成的摘要發送到郵箱。

⁠Usage 使用方法

以下為包含英文與繁體中文的設置指導。

⁠Docker 設置指南

⁠1. 拉取 Docker 映像

從 Docker Hub 拉取映像，請執行以下命令：

docker pull tbdavid2019/telegram-bot-summary:latest

⁠2. 運行 Docker 容器

執行以下命令來運行容器，請根據需求替換 <value>。

docker run -d \
    --name summary-gpt-bot \
    --restart unless-stopped \
    --env-file example.env \
    tbdavid2019/telegram-bot-summary:latest

⁠3. 環境變數說明

以下為主要環境變數：

LLM_BASE_URL：語言模型的 API 基本地址。
OPENAI_API_KEY：OpenAI 的 API 金鑰。
GROQ_API_KEY：GROQ 的 API 金鑰（用於 Whisper 功能）。
TELEGRAM_TOKEN：Telegram Bot 的令牌。
USE_AUDIO_FALLBACK：是否啟用無字幕影片處理（1 啟用，0 禁用）。
ENABLE_EMAIL：是否啟用郵件發送功能（1 啟用，0 禁用）。
SMTP_SERVER：SMTP 伺服器地址（如 Gmail）。
SMTP_PORT：SMTP 伺服器端口（如 Gmail 默認為 465）。
SMTP_USER：SMTP 用戶名（如 Gmail 地址）。
SMTP_PASSWORD：SMTP 密碼（或應用專用密碼）。
SMTP_CC_EMAILS：用逗號分隔的 CC 郵件地址列表。

⁠環境變數表格

⁠LLM Variables

Environment Variable	Description
`LLM_BASE_URL`	LLM API 的基本地址
`OPENAI_API_KEY`	用於 OpenAI API 的金鑰
`GROQ_API_KEY`	用於 GROQ Whisper 的 API 金鑰

⁠Bot Variables

Environment Variable	Description
`CHUNK_SIZE`	最大處理塊大小，默認值為 `2100`
`LLM_MODEL`	語言模型，例如 `chatgpt-4o-latest` 或 `llama-3.1`
`TELEGRAM_TOKEN`	Telegram 機器人的 API 令牌
`TS_LANG`	預設摘要語言，默認值為 `繁體中文`
`USE_AUDIO_FALLBACK`	是否啟用無字幕影片處理功能，`1` 表示啟用，`0` 表示禁用

⁠SMTP Variables

Environment Variable	Description
`ENABLE_EMAIL`	是否啟用郵件發送功能，`1` 表示啟用，`0` 表示禁用
`SMTP_SERVER`	SMTP 伺服器地址，例如 `smtp.gmail.com`
`SMTP_PORT`	SMTP 伺服器端口，例如 `465`（SSL）
`SMTP_USER`	SMTP 用戶名（通常是郵件地址）
`SMTP_PASSWORD`	SMTP 密碼（或應用專用密碼）
`SMTP_CC_EMAILS`	CC 收件人列表，用逗號分隔

⁠範例 `.env`

請參考 example.env 文件，配置所需的環境變數。

⁠更新 Docker 映像

當映像有新更新時，使用以下命令更新容器：

docker pull tbdavid2019/telegram-bot-summary:latest
docker stop summary-gpt-bot
docker rm summary-gpt-bot
docker run -d \
    --name summary-gpt-bot \
    --restart unless-stopped \
    --env-file example.env \
    tbdavid2019/telegram-bot-summary:latest


---

## 新增 `example.env`

以下為範例 `.env` 文件內容：

```plaintext
# 基本設置
CHUNK_SIZE=8000
LLM_MODEL=gemini-2.0-flash-exp
USE_AUDIO_FALLBACK=1

# API 金鑰
OPENAI_API_KEY=your_openai_api_key
GROQ_API_KEY=your_groq_api_key

# Telegram 配置
TELEGRAM_TOKEN=your_telegram_bot_token
ALLOWED_USERS=123456789,987654321

# MongoDB 配置
MONGO_URI=mongodb+srv://username:[email protected]/

# 顯示處理中訊息 (1 啟用，0 禁用)
SHOW_PROCESSING=1

# LLM URL
LLM_BASE_URL=https://gemini.david888.com/v1

# SMTP 配置
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=465
[email protected]
SMTP_PASSWORD=your_email_password
[email protected],[email protected]

# 啟用郵件發送功能 (1 啟用，0 禁用)
ENABLE_EMAIL=1

Tag summary

Recent tags

Content type