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 OpenAI-compatible endpoints and Ollama available as alternatives.

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.

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
LLM_PROVIDER=gemini
GEMINI_API_KEY=your_key

Command Center

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

terminal

settings

/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.