← All projects
Chat assistants

ChatGPT Telegram Bot

Run your own Telegram bot that chats using ChatGPT or Claude with your own API keys.

New this week

What it does

This project puts AI chat models from OpenAI and Anthropic inside Telegram. You set up your own bot, and you and the people you allow can chat with it like any Telegram contact.

It streams answers as they are written, can read images you send, turn voice notes into text, and create images. It has many chat modes, such as assistant, English tutor or travel guide, and you can add your own.

You pay the AI provider directly for what you use, and the bot can show how much you've spent.

Who it's for

Telegram users comfortable with a little setup who want a private AI chatbot.

Can I use it without coding?

With some setup. It runs with Docker after you fill in a settings file with your keys. New to this? Start here.

Can I run it?

Cost
Free, but needs an AI accountThe software is free, but it uses an online AI service (like OpenAI or Anthropic), which usually charges for use.
Runs on
Server, Linux, Mac, Windows
Computer
An ordinary computer is fine
Privacy
Sends what you give it to an online service
API key
Needed. An API key is a password-like code from an online AI service. What's that?

Try it

  1. Get an OpenAI API key, and optionally an OpenRouter key for Claude.
  2. Create a Telegram bot with Telegram's BotFather and copy its token.
  3. Put your keys into the project's settings files and start it with Docker.

Using Claude Code, Cursor or another AI coding assistant? Paste the prompt and it will walk you through the setup.New to this?

Before you install

  • Only download from the official GitHub page. Copies with similar names exist for many popular projects.
  • License (MIT): Very permissive: free to use, change and share, including for business.
  • Keep your API key private. Never paste it into websites or share it, and set a spending limit with the AI service.
  • What you type or upload is sent to an online service. Avoid sharing private or sensitive information.
  • More on staying safe

Where people are talking about it