> For the complete documentation index, see [llms.txt](https://help.telebotcreator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.telebotcreator.com/getting-started/readme.md).

# Introduction to Telebot Creator

*Telebot Creator Documentation — Platform v7.1.2 · Telegram Bot API 10.1*

*Last updated: June 2026 | Maintained by Telebot Creator Team*

## What is Telebot Creator?

Telebot Creator (TBC) is a **free platform for building, hosting, and managing Telegram bots**. You don't need your own server, you don't need to pay anything, and you can go from zero to a live bot in under 5 minutes.

TBC uses **TPY (Telebot Python)**, a custom scripting language based on Python. TPY comes with **30+ built-in libraries** for AI, payments, blockchain, data management, webhooks, and more — so you can build powerful bots without installing anything.

### Platform Statistics (2026)

| Metric                    | Value        |
| ------------------------- | ------------ |
| **Active Bots**           | 80,000+      |
| **Total Bots Created**    | 150,000+     |
| **Telegram Users Served** | 20,000,000+  |
| **TBC Platform Version**  | 7.1.2        |
| **Telegram Bot API**      | 10.1         |
| **Libraries**             | 30+ built-in |

> **Two version numbers, two different things.** The **TBC platform version** (currently **7.1.2**) tracks the Telebot Creator product itself — its TPY runtime, libraries, dashboard, and services. The **Telegram Bot API version** (currently **10.1**) tracks how much of Telegram's official Bot API the `bot` object supports. They are independent: a platform release can ship without changing the Bot API level, and a Bot API bump can ship without a platform version change.

***

## Quick Start — Create a Bot in 5 Minutes

1. **Register** — Create a free account at [telebotcreator.com](https://telebotcreator.com/register).
2. **Get a Bot Token** — Open Telegram, message [@BotFather](https://t.me/BotFather), use `/newbot`, and copy the API token.
3. **Add Your Bot** — On the TBC dashboard, click **"Add New Bot"**, paste your token, and click **"Create Bot"**.
4. **Write Your First Command** — Click on your bot, go to Commands, add a `/start` command with this code:

   ```python
   bot.sendMessage("Hello! Welcome to my bot 🚀")
   ```
5. **Start Your Bot** — Click the Start button. Your bot is now live on Telegram!

> **Need help?** Join the [TBC Community Group](https://t.me/telebotcreatorbetachat) on Telegram.

***

## What Are Commands?

Commands are the building blocks of every TBC bot. When a Telegram user sends a message like `/start` or `/help`, your bot runs the TPY code you wrote for that command.

```python
# /start command example
first_name = message.from_user.first_name
bot.sendMessage(f"Hey {first_name}! Welcome to my bot. Use /help to see what I can do.")
```

Commands can:

* Send text, photos, videos, files, stickers, and more
* Ask for user input and process it step by step
* Store and retrieve user data
* Make HTTP requests to external APIs
* Accept payments via crypto or traditional gateways
* Run AI models (GPT-4, Gemini, etc.)
* Schedule tasks up to 1 year in the future
* Broadcast messages to all your bot's users

***

## What is TPY?

**TPY (Telebot Python)** is TBC's custom scripting language. If you know basic Python, you already know TPY. If you don't know Python, TPY is simple enough to learn in a few hours.

**Key features:**

* **Python-based syntax** — Variables, if/else, loops, functions, try/except all work the same way
* **30+ built-in libraries** — AI (OpenAI, Gemini), payments (Coinbase, TON), data (CSV, Resources), HTTP, webhooks, and more
* **Pre-defined variables** — `msg`, `message`, `bot`, `Bot`, `User`, `Account`, `params`, `u`, `options` are ready to use
* **Sandboxed environment** — Each bot runs in isolation. No `eval()`, `exec()`, or system module access for security
* **Up to 160 seconds** execution time per command

***

## Points System — It's Free

TBC uses a points system for bot hosting. Here's the deal:

| Feature                | Details                          |
| ---------------------- | -------------------------------- |
| **New Account Points** | 100,000 points free              |
| **Cost Per Command**   | 1 point                          |
| **Monthly Renewal**    | Yes, every month                 |
| **Extra Points**       | Request free from admins anytime |
| **Hidden Fees**        | None — it's genuinely free       |

Each command execution (like responding to `/start`) costs 1 point. That means a new account can handle **100,000 command executions per month** for free.

### Advertising Policy

TBC keeps the platform free through minimal, non-intrusive advertising:

* Ads appear only **2-4 times per month** as a single broadcast message
* No continuous spam or pop-ups
* Your bot users get an uninterrupted experience

***

## Key Features at a Glance

| Feature                   | Description                                                                                                                             |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Free Hosting**          | No servers to manage. TBC hosts your bots for free.                                                                                     |
| **AI Integration**        | Built-in OpenAI (GPT-4o), Gemini, and OpenRouter support                                                                                |
| **Crypto Payments**       | Coinbase Commerce, TON blockchain, Web3 (all EVM chains)                                                                                |
| **Broadcasting**          | Send messages to all bot users at once                                                                                                  |
| **Scheduled Commands**    | Schedule actions from 1 second to 366 days ahead                                                                                        |
| **Webhooks**              | Real-time integrations with external services                                                                                           |
| **Data Storage**          | User-level and bot-level data storage, CSV files, Resources system                                                                      |
| **Multi-Bot Management**  | Manage all bots from one account using the Account class                                                                                |
| **Bot Transfer**          | Transfer bot ownership to another account                                                                                               |
| **Bot Recovery**          | Recover deleted bots within 90 days                                                                                                     |
| **Inline Queries**        | Handle inline mode, callback queries, payments, and all Telegram update types                                                           |
| **Telegram Bot API 10.1** | Full coverage of the latest Telegram features — Gifts, Stories, Business accounts, Checklists, Suggested posts, Verification, and Stars |
| **Image Processing**      | OpenCV and Pillow libraries for image manipulation                                                                                      |
| **Code Editor**           | Built-in TPY code editor with syntax highlighting and autocomplete                                                                      |
| **Bot Export / Import**   | Export a bot to a portable file, import it back, and round-trip through the AI assistant                                                |
| **Docs MCP Server**       | Public Model Context Protocol endpoint so any AI assistant can read the live TBC docs                                                   |

***

## Built-in Libraries

TBC includes 30+ libraries you can use directly in your code — no installation needed:

| Category       | Libraries                                                                                            |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| **AI**         | `libs.openai_lib` (GPT-4o, Assistants API), `libs.gemini_lib` (Gemini Flash/Pro), OpenRouter support |
| **Payments**   | `libs.Coinbase`, `libs.Coinpayments`, `libs.Oxapay`, `libs.MDxchange`                                |
| **Blockchain** | `libs.TonLib` (TON), `libs.web3lib` (all EVM chains), `libs.Crypto`                                  |
| **Data**       | `libs.CSV`, `libs.Resources` (points, credits, leaderboards)                                         |
| **Media**      | `libs.OpenCV`, `libs.Pillow`                                                                         |
| **HTTP**       | `libs.customHTTP`, built-in `HTTP` module                                                            |
| **Webhooks**   | `libs.Webhook`                                                                                       |
| **Utilities**  | `libs.Random`, `libs.DateAndTime`                                                                    |

***

## The New UI (Version 2)

Telebot Creator now features a modern, redesigned dashboard:

* **Dark theme** with a clean, professional design
* **Bot management** — Add, start, stop, and delete bots from one screen
* **Command editor** — Built-in TPY code editor with syntax highlighting, autocomplete, and AI-powered code suggestions
* **Error logs** — View and debug command errors with timestamps
* **Settings** — Update bot tokens, manage transfers, and configure bot options
* **Notifications** — Real-time alerts for bot events
* **Mobile-friendly** — Fully responsive design that works on all devices

***

## Community & Support

* **Telegram Help Group**: [t.me/telebotcreatorbetachat](https://t.me/telebotcreatorbetachat)
* **Documentation**: [help.telebotcreator.com](https://help.telebotcreator.com)
* **ChatGPT AI Assistant**: [Telebot Creator AI GPT](https://chatgpt.com/g/g-67ce8f8e7da081918cc244a92dc5aa55-telebot-creator-ai)
* **Website**: [telebotcreator.com](https://telebotcreator.com)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.telebotcreator.com/getting-started/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.