Dump-Assistant-Bot: Your Smart AI Sidekick for Telegram

Automate routine tasks and engage your communities with a context-aware assistant powered by Gemini, OpenAI, or optional local Ollama.

terminal Get Started on GitHub View Documentation

smart_toy

Bot Processing...

"Analyzing the provided link. Here is the summary of the key findings..."

Hyper-Competent Automation

Designed for community managers who need fast cloud AI by default, with OpenAI-compatible and local options when they need them.

database

Cloud AI

Gemini is the recommended default with Structured Outputs, alongside OpenAI-compatible and Ollama endpoints.

history

Context Awareness

Caches previous posts and conversation threads to provide coherent, relevant responses every time.

link

Link Reading

Automatically analyzes articles, PDFs, and web pages shared in the chat to provide instant summaries.

forum

'Instigator' Mode

Keep the conversation flowing. The bot can auto-comment to stimulate engagement in quiet groups.

table_chart

Rich Messages

Supports Telegram Bot API 10.1+ native tables, lists, and LaTeX formulas with automatic fallback.

security

Security Hardening

Protects against DNS rebinding, filters private IP addresses, and secures relay target messaging.

person_search

Owner Co-pilot

Personalized command set for administrators to manage their digital presence with surgical precision.

shield

Anti-spam & Focus

Smart filtering detects noise and spam, keeping your Telegram feed clean and focused on what matters.

The Neural Pipeline

send

User sends a message or link

arrow_forward

robot_2

The Bot

Applies filters and retrieves context

arrow_forward

memory

Cloud LLM

Gemini or OpenAI generates the response

arrow_forward

check_circle

Response

Instant, smart feedback in Telegram

Quick Installation

Get your assistant up and running in minutes. Requires Node.js and an API key for your selected cloud provider.

Step 1: Install Dependencies content_copy

npm install

Step 2: Configure Provider content_copy

cp .env.example .env

Step 3: Configuration content_copy

# .env
TELEGRAM_BOT_TOKEN=your_token
BOT_USERNAME=your_bot_username
ALLOWED_CHAT_IDS=-1001234567890
OWNER_USER_IDS=123456789

LLM_PROVIDER=gemini
GEMINI_API_KEY=your_key
GEMINI_MODEL=gemini-3.5-flash

Command Center

Control every aspect of your assistant with simple, powerful Telegram commands.

terminal

settings

/post Publish markdown post to channel

/postlink Generate post from URL & publish

/chatid Get current chat context

/status Check bot health & LLM

/on Enable AI automation

/off Pause assistant features

/usage Show detailed token usage statistics

Technical FAQ

What are the minimum hardware requirements? expand_more

The recommended cloud setup only needs Node.js 22+ and a network connection. Local Ollama mode is optional and depends on the model size and your CPU/GPU.

Can I switch between Gemini, OpenAI, and Ollama? expand_more

Yes. Set `LLM_PROVIDER` to `gemini`, `openai`, or `ollama`, then fill the matching API key or local Ollama settings in `.env`.

How does it handle long articles? expand_more

The bot fetches link content, extracts the main text, and provides a concise summary that fits within Telegram's message limits while preserving important context.

Is the bot secure against malicious links and DNS rebinding? expand_more

Yes. The built-in URL fetcher enforces strict security validations: it filters private IP ranges (blocking SSRF), restricts redirection hops, and prevents DNS rebinding to protect internal networks.

What are "Rich Messages" and how does the bot support them? expand_more

The bot supports Telegram Bot API 10.1+ Rich Messages, converting standard Markdown output (including lists, tables, and LaTeX formulas) into HTML. It also implements an automatic safety fallback to standard messages if client or server rendering fails.

How do I publish posts directly to my channel using the bot? expand_more

As an owner, send `/post ` to the bot in a direct message. You can optionally attach an image, which the bot will automatically host and format into a native Telegram Rich Message. The bot will respond with a direct link to the post.