A private AI-powered Telegram assistant with text and voice chat, image generation and editing, web search, document analysis, projects, memory, scheduled tasks, and usage controls. Built with TypeScript and OpenAI.
// readme
Telegram AI Bot Pro
A private TypeScript Telegram assistant with text and voice conversations, photo analysis and editing, image generation, web search with sources, document questions, projects, named conversations, explicit saved memory, usage controls, streaming replies and durable background jobs. MIT licensed.
“Pro” names this repository’s feature set. It does not grant a ChatGPT subscription or provider account access.
Get started
Requirements: Node.js 26.13+ within Node 26, npm 11, a Telegram bot token, an OpenAI project API key with billing and model access. Outgoing voice messages require FFmpeg with libopus; the Docker image includes it. Incoming voice transcription needs no FFmpeg.
nvm use
npm ci
cp .env.example .env
# Fill in required settings before starting.
npm run dev
Required settings:
TELEGRAM_API_KEY: token from @BotFather.OPENAI_API_KEY: private OpenAI project key.ALLOWED_TELEGRAM_USER_IDS: comma-separated numeric IDs. Only these users in private chats are processed.
Default chat model: gpt-6.1-sol. Override it with OPENAI_CHAT_MODEL using a Responses model supporting vision, document…