---
id: telebot
version: "0.0.5"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# telebot — A Telegram bot library, with simple route decorators.

License: permissive · Maintenance: abandoned · Downloads: 237.0K/mo

## What it is and what it does

Telebot is a lightweight Telegram bot framework that layers route-based message handling on top of pyTelegramBotAPI. It lets you define bot behavior using decorators that match incoming messages against regex patterns, similar to web frameworks. When a message matches a route, the decorated function receives the message object and any captured groups from the pattern.

The package is designed for simple bots that respond to commands and echo messages. It handles polling for updates from Telegram and dispatching them to the appropriate handler. However, the project is abandoned—the last commit was 2023-04-26 and it remains in Pre-Alpha status, meaning it was never considered feature-complete and has received no maintenance.

Use it for:

- Building a simple Telegram bot that responds to specific commands using route patterns without writing polling logic.
- Prototyping a Telegram bot with decorator-based message routing during early development.
- Creating a bot that echoes or transforms user messages based on regex-matched patterns.
- Learning Telegram bot development with a lightweight routing abstraction over pyTelegramBotAPI.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Telegram bot library with route-based message handling that wraps pyTelegramBotAPI and provides decorator-style command routing for building simple bots.

No. The package is abandoned and in Pre-Alpha, with no updates since 2023-04-26. While install friction is low and the MIT license is permissive, the lack of maintenance means it will not receive bug fixes or compatibility updates as Telegram's API evolves. For new projects, use an actively maintained Telegram bot library instead.

## Install

pip install telebot
uv add telebot
poetry add telebot

## Installing telebot

Before you install: Low install friction with only two runtime dependencies (pyTelegramBotAPI and requests). However, the package is abandoned—last commit was 2023-04-26 and receives no updates. Pre-Alpha status signals incomplete development.

License in practice: MIT license is permissive and places no restrictions on use, modification, or distribution for commercial or private projects.

Quickstart:

pip install telebot

from telebot import TeleBot

app = TeleBot(__name__)
app.config['api_key'] = 'your_bot_key'

@app.route('/command ?(.*)')
def example_command(message, cmd):
    app.send_message(message['chat']['id'], f"Command: {cmd}")

app.poll(debug=True)

Requires a valid Telegram bot API key; package is abandoned and may not work with current Telegram API.

Verify before relying:

- Whether the package remains compatible with current Telegram Bot API endpoints.
- Whether pyTelegramBotAPI dependency versions are pinned or if breaking changes affect telebot.
- Active maintenance status of the underlying pyTelegramBotAPI library.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 237.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

telegram bot library, telegram bot routing, telegram message handler, bot command decorators, telegram bot framework, telegram-bot, abandoned

[View on SkillFed](https://skillfed.io/packages/telebot) · [View on PyPI](https://pypi.org/project/telebot/)