PyPI · #4406 most downloaded on PyPI

pytelegrambotapi

4.37.0829K downloads/moeternnoir/pyTelegramBotAPI ↗New releases in your daily digest, changelog included.

Python Telegram bot API.

Last release 13 days ago
21 Sep 2026
Ships fairly regularly
a new release about every 5 weeks
Most releases are documented
notes for 46 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
147 releases · first in 2015

Release timeline

147 releases since 2015

2015201720192021

Releases

4.37.021 Sept 2026
Bot API support bumped up to v.10.3. Bugfixes and internal redesign.
Bot API support bumped up to v.10.3.
Bugfixes and internal redesign.
Open source →
4.36.113 Aug 2026
Minor fixes in RichText processing
What's Changed

Minor fixes in RichText processing
Open source →
4.36.018 Jul 2026
Bot API support bumped up to v.10.2
Bot API support bumped up to v.10.2

One column per quarter.

4.35.012 Jul 2026

Bot API support bumped up to v.10.1

Open source →

4.34.03 Jun 2026

Bot API support bumped up to v.10.0

Open source →

4.33.011 Apr 2026

Bot API support bumped up to v.9.6

Open source →

4.32.09 Mar 2026

Bot API support bumped up to v.9.5

Open source →

4.31.014 Feb 2026

Bot API support bumped up to v.9.4

Open source →

4.30.017 Jan 2026

Bot API support bumped up to v.9.3

Open source →

4.29.13 Sept 2025

Nothing changed, just bumped version to push sone fixes not released to PyPi.

Open source →

4.29.030 Aug 2025

Bot API support bumped up to v.9.2

Open source →

4.28.026 Jul 2025

Bot API support bumped up to v.9.1

Open source →

4.27.03 May 2025

Bot API support bumped up to v.9.0 (together with v.8.3)

Open source →

4.26.04 Jan 2025

Bot API support bumped up to v.8.2

Open source →

4.25.07 Dec 2024

Bot API support bumped up to v.8.1 (together with v.8.0)

Open source →

4.24.015 Nov 2024

Bot API support bumped up to v.7.11.

Python 3.8 removed from support due to EOL. Python 3.13 added to support due to release.

Open source →

4.23.020 Sept 2024

Bot API support bumped up to v.7.10 (together with v.7.9)

Open source →

4.22.115 Aug 2024

Nothing published for this version

4.22.05 Aug 2024

Bot API support bumped up to v.7.8.

Bot API support bumped up to v.7.8.
Minor fixes and improvements.

Open source →

4.21.08 Jul 2024

Bot API support bumped up to v.7.7 (together with v.7.6)

Open source →

4.20.022 Jun 2024

Nothing published for this version

4.19.216 Jun 2024

Nothing published for this version

4.19.18 Jun 2024

Nothing published for this version

4.19.06 Jun 2024

Bot API support bumped up to v.7.4

Open source →

4.18.116 May 2024

Nothing published for this version

4.18.014 May 2024

Bot API support bumped up to v.7.3

Open source →

4.17.09 Apr 2024

Bot API support bumped up to v.7.2

Open source →

4.16.117 Feb 2024

Nothing published for this version

4.16.017 Feb 2024

Bot API support bumped up to v.7.1

Open source →

4.15.516 Feb 2024

Nothing published for this version

4.15.430 Jan 2024

Nothing published for this version

4.15.326 Jan 2024

Nothing published for this version

4.15.215 Jan 2024Deprecated

Added deprecation stubs for Message fields in InaccessibleMessage

What's Changed

Fix methods delete_messages and forward_messages.
Fix link_preview_options passing for Telebot
Added deprecation stubs for Message fields in InaccessibleMessage

Open source →

4.15.114 Jan 2024

Nothing published for this version

4.15.014 Jan 2024

Set of actively used properties had changed their format! Please, pay attention on new format of passing:

Bot API Huge Update - 7.0, introducing reactions, replies and some other changes.

Warning

Set of actively used properties had changed their format! Please, pay attention on new format of passing:

disable_web_page_preview
reply_to_message_id
allow_sending_without_reply
forward_from
forward_from_chat
forward_from_message_id
forward_signature
forward_sender_name
forward_date

Open source →

4.14.119 Dec 2023

Fix ExceptionHandler handle() method as async for async telebot

What's Changed

Fix protect_content hint
Sending InputFile fix
Fix ExceptionHandler handle() method as async for async telebot
Update the available content_types in README

Open source →

4.14.024 Sept 2023

Bot API support bumped up to v.6.9

Open source →

4.13.020 Aug 2023

Bot API support bumped up to v.6.8

Open source →

4.12.018 May 2023

## Bot API support bumped up to v.6.7

Bot API support bumped up to v.6.7

Open source →

4.11.015 Apr 2023Deprecated

We recommend switching to proper functions, classes, parameters if you are using deprecated ones. Deprecated functions will be deleted soon.

Bot API support bumped up to v.6.6

Deprecation warnings

We recommend switching to proper functions, classes, parameters if you are using deprecated ones. Deprecated functions will be deleted soon.

Open source →

4.10.05 Feb 2023Deprecated

We recommend switching to proper functions, classes, parameters if you are using deprecated ones. Deprecated functions will be deleted soon.

Bot API support bumped up to v.6.5

Deprecation warnings

We recommend switching to proper functions, classes, parameters if you are using deprecated ones. Deprecated functions will be deleted soon.
If you are using restrict_chat_member method, please pass permissions parameter instead of passing all boolean values for different parameters. Passing parameters one-by-one to function is now deprecated and will be removed soon.

Contributor

@coder2020official

Open source →

4.9.02 Jan 2023

Bot API support bumped up to v.6.4

Bot API support bumped up to v.6.4

Contributor

@coder2020official

Open source →

4.8.028 Nov 2022

Bot API support bumped up to v.6.3

Bot API support bumped up to v.6.3
Extended exception handler behaviour for async version
Fixed issue related to ContinueHandling And some other minor improvements...

Main Contributor

@coder2020official

Open source →

4.7.121 Oct 2022

Support ContinueHandling to continue with other handlers after handler is found

What's Changed

Support ContinueHandling to continue with other handlers after handler is found
Logging improvements: colored logs etc.
Added some frequent parameters to classes
Starlette ASGI example
Fixed bug with searching a new handler after the execution of handler
Fixed difference between request_timeout and timeout
More bug fixes

Open source →

4.7.015 Aug 2022

Bot API support bumped up to v.6.2

Bot API support bumped up to v.6.2
class InputFile added. Supports various ways to pass files to corresponent functions.

Main Contributor

@coder2020official

Open source →

4.6.127 Jul 2022

run_webhooks() function for both versions

What's Changed

run_webhooks() function for both versions
Passing data to handler through middlewares
Typehints for set_state improved
Some built-in custom filters were improved
Fixed timeouterror for async
Significant documentation improvements
Extended exception handler behaviour
update_sensitive field for async
Session improvements for async
... and more

Main Contributor

@coder2020official

Open source →

4.6.023 Jun 2022

Bot API support bumped up to v.6.1

Bot API support bumped up to v.6.1
class File parse fix
copyMessage typehint fixed
improvements in formatting
fixed default parse mode in TeleBot(sync)
added an option to set default parse mode for AsyncTeleBot(async)
aiohttp session management improvements(for async)
async long polling improvements

Open source →

4.5.17 May 2022

Added sync i18n class based middleware

What's Changed

Added sync i18n class based middleware
Bugfix in answer_web_app_query
Mistake in ChatAdministratorRights
Markdown & Html functions added (Beta version, still in progress)https://github.com/eternnoir/pyTelegramBotAPI/pull/1524
Polling exception logging updated
Fixed proxy for asynctelebot

Open source →

4.5.023 Apr 2022

Bot API support bumped up to v.6.0

Open source →

4.4.116 Apr 2022

Extended custom exception_handler behaviour.

Changelog(short version):

Extended custom exception_handler behaviour.
Improved states
New Text Filter
Documentation improvements
I18N examples involving middlewares for async
And more...

Open source →

4.4.01 Feb 2022

Bot API support bumped up to v.5.7. Thanks to @coder2020official

Synchronous storage rewritten. Redis storage added.
pass_bot parameter added for register_XXX_handler
register_middleware_handler added
Improve states example And more.

Open source →

4.3.110 Jan 2022

Nothing published for this version

4.3.08 Jan 2022

Bot API support bumped up to v.5.6. You know, whom to send thanks: @coder2020official

Open source →

4.2.28 Dec 2021

Bot API support bumped up to v.5.5. Thanks again to @coder2020official

Open source →

4.2.14 Dec 2021

Absolutely new AsyncTeleBot. By @coder2020official

See: https://github.com/eternnoir/pyTelegramBotAPI#asynctelebot for details.

Open source →

4.2.08 Nov 2021

Bot API support bumped up to v.5.4. Thanks to @coder2020official

Added possibility to override request sending for testing purposes or making some requests post-processing. See: https://github.com/eternnoir/pyTelegramBotAPI#testing

Open source →

4.1.19 Oct 2021

States: new feature, based on custom filters: states.

See the example: https://github.com/eternnoir/pyTelegramBotAPI/blob/master/examples/custom_states.py

Open source →

4.1.025 Sept 2021

New feature: custom message filters!

Now you can filter message handlers with whatever you want.

See for description: https://github.com/eternnoir/pyTelegramBotAPI#custom-filters and for examples: https://github.com/eternnoir/pyTelegramBotAPI/tree/master/examples/custom_filters

Open source →

4.0.113 Sept 2021

New feature: custom message filters!

See https://github.com/eternnoir/pyTelegramBotAPI#custom-filters and https://github.com/eternnoir/pyTelegramBotAPI/tree/master/examples/custom_filters

Open source →

4.0.030 Aug 2021

Library is now support the latest Bot API (v.5.3)! (With some limitations, see compatibility list in readme).

Great news!

Library is now support the latest Bot API (v.5.3)! (With some limitations, see compatibility list in readme).

We hope to keep it now up to date with the further Bot API updates.

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →