Self-hosted team chat running on Cloudflare Workers, with realtime messaging, a two-way Telegram bridge, and server-side encrypted messages and files.
tbxark/ChatGPT-Telegram-Workers
A single-file Telegram bot that runs ChatGPT and other AI providers on Cloudflare Workers, serverless with no local setup.
- Stars
- 3,813
- Forks
- 894
- Open issues
- 15
- Last commit
- 4 days ago
What is it?
ChatGPT-Telegram-Workers lets you run your own Telegram chatbot backed by ChatGPT and other AI services. The bot is deployed as a serverless function on Cloudflare Workers, and the project is distributed as a single file that can be pasted directly, so no local development environment or domain name is needed.
Beyond the default OpenAI setup, it supports several providers including Cloudflare AI, Anthropic, Mistral, DeepSeek and Groq. Configuration is stored in Cloudflare KV, and a Telegram Mini App admin panel is provided for managing providers and settings. Users can define custom commands to switch models or personas, and a plugin system allows extension.
The project also documents deployment to Vercel and Docker, and includes streaming output and text-to-image generation.
Key features
- 01Serverless deployment on Cloudflare Workers, with Vercel and Docker options
- 02Supports multiple AI providers such as OpenAI, Anthropic, Mistral and DeepSeek
- 03Web admin panel delivered as a Telegram Mini App
- 04Custom commands for switching models and bot presets
- 05Streaming output and text-to-image generation
- 06Plugin system for custom extensions
Use cases
- Running a personal ChatGPT assistant inside Telegram without maintaining a server
- Giving a small group or team a shared AI bot with a custom persona
- Trying out different AI providers from one Telegram interface
Quick start
- 1
Deploy in one click with the Cloudflare deploy button (creates KV namespace, asks for bot token)
- 2
Or follow the Cloudflare Workers deployment guide in the docs
Things to know
- Requires a Cloudflare account and a Telegram bot token.
- Most AI providers need their own paid API keys.
Topics
FAQ
- What is ChatGPT-Telegram-Workers?
- A single-file Telegram bot that runs ChatGPT and other AI providers on Cloudflare Workers, serverless with no local setup. ChatGPT-Telegram-Workers lets you run your own Telegram chatbot backed by ChatGPT and other AI services. The bot is deployed as a serverless function on Cloudflare Workers, and the project is distributed as a single file that can be pasted directly, so no local development environment or domain name is needed.
- Is ChatGPT-Telegram-Workers free to use? What license does it have?
- ChatGPT-Telegram-Workers is open source under the MIT license. Check the license terms before using it in commercial products.
- Is ChatGPT-Telegram-Workers still maintained?
- Actively maintained. The last commit to ChatGPT-Telegram-Workers was on Nov 3, 2026.
- What can I use ChatGPT-Telegram-Workers for?
- Running a personal ChatGPT assistant inside Telegram without maintaining a server Giving a small group or team a shared AI bot with a custom persona Trying out different AI providers from one Telegram interface
- How do I install ChatGPT-Telegram-Workers?
- Deploy in one click with the Cloudflare deploy button (creates KV namespace, asks for bot token) Or follow the Cloudflare Workers deployment guide in the docs
- Where can I get ChatGPT-Telegram-Workers?
- The source code and installation instructions are on GitHub: https://github.com/tbxark/ChatGPT-Telegram-Workers
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A Telegram bot that gives users a streaming ChatGPT-style chat experience, backed by Azure OpenAI or native OpenAI.
A PHP SDK for building Telegram bots on the Telegram Bot API, with built-in Laravel support.
A Bob translation plugin that uses OpenAI, Gemini, MiniMax or OpenAI-compatible APIs for translation, polishing and grammar correction.
A small, ultrafast web framework built on Web Standards that runs on Cloudflare Workers, Deno, Bun, AWS Lambda, Node.js and more.
A self-hostable email service built on Cloudflare Workers, letting you create multiple mailboxes under one domain with sending, attachments and a responsive web UI.