Dummy Gemini Bot is a fully self-hostable Telegram bot that brings Google Gemini AI into your group chats and DMs. It ships with a witty Persian persona out of the box, supports images and voice notes, downloads media from Instagram, YouTube, Threads, and more — and includes a React-based admin WebApp dashboard for real-time moderation and configuration.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/AmiraliNotFound/dummy-gemini-bot/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get your bot running in under five minutes with Docker.
Deployment Guide
Deploy with Docker Compose or systemd on any Linux VPS.
Configuration
Set environment variables, model IDs, TTS engines, and personas.
Command Reference
Every user and admin command with usage examples.
What’s Inside
Resilient AI Chat
Primary + fallback Gemini model queue with context-aware history and per-chat persona overrides.
Dual-Engine TTS
Microsoft Edge TTS and Google Gemini TTS with automatic failover and configurable voices.
Media Downloader
Inline download of Instagram, YouTube, Threads, Pinterest, and Twitter content.
Admin Dashboard
React WebApp with stats, moderation controls, broadcast, and live quota monitoring.
Daily Summaries
Scheduled sarcastic group-chat summaries posted automatically every day.
REST API
Authenticated aiohttp REST API powering the admin dashboard on port 8080.
Getting Started
Get your API keys
Obtain a Telegram Bot Token from @BotFather and a Gemini API key from Google AI Studio.
Configure your environment
Copy
.env.example to .env and fill in TELEGRAM_TOKEN, GEMINI_API_KEY, and ALLOWED_ADMINS.Start with Docker
Run
docker-compose up -d --build to build the React frontend and Python backend in one step.The bot defaults to a witty, sarcastic Persian (Tehrani) persona. You can change the system prompt, switch models, and configure every per-chat override from the admin dashboard — no restarts required.