telethon
Full-featured Telegram client library for Python 3
1.44.0
3.7M downloads/mo
#2515 most downloaded on PyPI
source
What this package is like to depend on
Last release 2 months ago
15 Jun 2026
Ships fairly regularly
a new release about every 2 months
This project publishes no release notes
the list below is its commits, not an announcement
1 version withdrawn
withdrawn after publishing
10 years old
242 releases · first in 2016
8 releases in the last 12 months
see the full history below
Release timeline
240 releases · Sep 2016 to Jun 2026Releases
latest 60 of 242-
1.44.015 Jun 2026Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.43.2andv1.44.0there were 10 commits, 9 of them substantive:- Update to layer 227 (again) (#40)
- Handle ChatInviteJoinResult return type from importChatInvite and joinChannel (#38)
- Update to Layer 227 (#37)
- Mark parse_mode as optional in send_file() and edit_message() (#31)
- Update to layer 225 from tdlib
- Fix FutureSalts pending state lookup (#30)
- Update to layer 225 (#27)
- Filter None out of possible_names on download
- Add executable bit back to files with shebang
-
1.43.220 Apr 2026Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.43.1andv1.43.2there were 2 commits, 1 of them substantive:- Fix high CPU usage when connection is closed by remote (#23)
-
1.43.113 Apr 2026Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.43.0andv1.43.1there were 6 commits, 5 of them substantive:- Remove duplicate warnings import leading to error
- Remove regex implications from USERNAME_INVALID error message (#20)
- Remove executable bit
- Try generating TL on docs post_install
- Remove deprecated license classifier
-
1.43.010 Apr 2026Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.42.0andv1.43.0there were 27 commits, 26 of them substantive:- Support building with Hatch
- Update stale GitHub reference
- Explicitly mention policy against AI usage
- Update to layer 224 (#16)
- Fix
get_running_loop()for Python 3.14 (#11) - Update to layer 223 (#7)
- Update links to Codeberg
- Support blockquote expandable tag when using html parse_mode (#4)
- Fix Button helper regressions introduced by commit df95884 (#5)
- Support styles on inline buttons (#1)
- Fix typo on generated docs (#2)
- Add error code for sending videos in chat (#4741)
- Fix InvalidBuffedError on incomplete recv data (#4740)
- Update to layer 222
- Catch-all unknown RPCError and treat them as transient during getDifference
- Fix doc typos on some raw API types (#4732)
- Update to layer 221
- Add errors for chat restrictions (#4729)
- Update proxy docs and warn if python-socks is not installed
- Fix Telethon could not be imported without sqlite3
…and 6 more.
-
1.42.005 Nov 2025Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.41.1andv1.42.0there were 9 commits, 7 of them substantive:- Fix path traversal when downloading documents
- Fix Python 3.14 support
- Update to layer 216
- Stop using the event_loop fixture (#4670)
- Correct handling of trailing zeros in _rle_encode (#4702)
- Add BotCommandsTooMuchError class (#4700)
- Ensure document spoiler is preserved in utils.get_input_media
-
1.41.204 Sep 2025Nothing published for this version
-
1.41.104 Sep 2025Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.41.0andv1.41.1there were 3 commits, 2 of them substantive:- Fix incorrect async session warning
- Revert "Fix spoilers when sending InputPhoto and InputDocument"
-
1.41.001 Sep 2025Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.40.0andv1.41.0there were 28 commits, 27 of them substantive:- Update to layer 214 (#4695)
- Update to layer 211 (again) (#4683)
- Update to layer 211
- Add experimental support for async sessions (#4667)
- Fix spoilers when sending InputPhoto and InputDocument
- Update to layer 210
- Reduce data manipulation operations
- Add isal gzip decompressor
- Update to layer 209
- Update to layer 207
- Update to layer 206 (#4654)
- Handle cases when Message.reply_to is MessageReplyStoryHeader
- Update to layer 204
- Support tg-emoji tag when using html parse_mode
- Cleanup usage of removed inline_only parameter (#4630)
- Add
persistentandplaceholderoptions to buttons (#4629) - Add custom error types for new FROZEN codes
- Add customizable 'mime_type' for send_file
- Update FileLike type hint to better reflect valid types (#4620)
- Update to layer 203
…and 7 more.
-
1.40.021 Apr 2025Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.39.0andv1.40.0there were 17 commits, 17 of them substantive:- Update to v1.40
- Fix time offset check was in opposite branch
- Update time offset if first message is badMsgNotification
- Combine tdlib and tdesktop schemas
- Fix layer 201 (#4596)
- Fix issues raising errors, media dl and reply markup (#4592)
- Update to Layer 201
- Delete dated documentation section
- Add missing param on photo-to-input conversion
- skip ChannelParticipantLeft in _ParticipantsIter
- Update to layer 200
- Add missing input conversion for MessageMediaGeoLive
- Add send_as and effect parameters in high level
- Call getDifference on login to ensure qts is up to date
- Make URL regex match everything except ]
- Make URL regex match anything again
- Clarify warning when reusing unintended session (#4568)
-
1.39.020 Feb 2025Commits, not release notes
Compare on the forge →This project publishes no release notes. Between
v1.38.1andv1.39.0there were 17 commits, 17 of them substantive:- Update to v1.39
- Update to layer 199
- Consider range list-like
- fix: support batch sending of image URLs and video URLs in albums
- Make markdown URL regex less greedy
- Fix overlapping URLs and improve overlapping in md
- Unconditionally match text and link text in markdown
- Update to layer 198
- Improve edit_message message type hint
- Respect receive_updates=False
- Document drop_author and add drop_media_captions
- Fix IOError with some image modes in photo resize
- Add missing parameters to Message constructor (#4529)
- Updated to Layer 196 (#4525)
- Avoid error when trying to reset deadline for no msgbox entries
- Update to layer 195
- fix(session): persist session after
session.set_dc
-
1.38.118 Nov 2024Nothing published for this version
-
1.38.017 Nov 2024Nothing published for this version
-
1.37.023 Sep 2024Nothing published for this version
-
1.36.011 Jun 2024Nothing published for this version
-
1.35.024 Apr 2024Nothing published for this version
-
1.34.002 Feb 2024Nothing published for this version
-
1.33.108 Dec 2023Nothing published for this version
-
1.33.001 Dec 2023Nothing published for this version
-
1.32.112 Nov 2023Nothing published for this version
-
1.32.031 Oct 2023Nothing published for this version
-
1.31.117 Oct 2023Nothing published for this version
-
1.31.012 Oct 2023Nothing published for this version
-
1.30.313 Sep 2023Nothing published for this version
-
1.30.212 Sep 2023Nothing published for this version
-
1.30.112 Sep 2023 withdrawnaccidental push without pulling first
Nothing published for this version
-
1.30.010 Sep 2023Nothing published for this version
-
1.29.318 Aug 2023Nothing published for this version
-
1.29.224 Jul 2023Nothing published for this version
-
1.29.123 Jul 2023Nothing published for this version
-
1.29.023 Jul 2023Nothing published for this version
-
1.28.514 Apr 2023Nothing published for this version
-
1.28.207 Apr 2023Nothing published for this version
-
1.28.106 Apr 2023Nothing published for this version
-
1.28.006 Apr 2023Nothing published for this version
-
1.27.005 Feb 2023Nothing published for this version
-
1.26.122 Dec 2022Nothing published for this version
-
1.26.025 Nov 2022Nothing published for this version
-
1.25.414 Oct 2022Nothing published for this version
-
1.25.314 Oct 2022Nothing published for this version
-
1.25.227 Sep 2022Nothing published for this version
-
1.25.124 Sep 2022Nothing published for this version
-
1.25.030 Aug 2022Nothing published for this version
-
1.24.001 Dec 2021Nothing published for this version
-
1.23.009 Jul 2021Nothing published for this version
-
1.22.019 Jun 2021Nothing published for this version
-
1.21.116 Mar 2021Nothing published for this version
-
1.2114 Mar 2021Nothing published for this version
-
1.2027 Feb 2021Nothing published for this version
-
1.19.508 Feb 2021Nothing published for this version
-
1.19.406 Feb 2021Nothing published for this version
-
1.19.306 Feb 2021Nothing published for this version
-
1.19.202 Feb 2021Nothing published for this version
-
1.19.126 Jan 2021Nothing published for this version
-
1.19.005 Jan 2021Nothing published for this version
-
1.18.228 Nov 2020Nothing published for this version
-
1.18.128 Nov 2020Nothing published for this version
-
1.18.028 Nov 2020Nothing published for this version
-
1.17.525 Oct 2020Nothing published for this version
-
1.17.423 Oct 2020Nothing published for this version
-
1.17.323 Oct 2020Nothing published for this version