NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3470 most downloaded on PyPI
Microsoft Bot Framework Bot Builder SDK for Python.
Last release 9 months ago
05 Jan 2026
Release timing varies
gaps range from 9 days to 9 months
Some releases are documented
notes for 20 of 37 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
51 releases · first in 2018
Bot Framework Python SDK has reached end-of-life. This is the last planned release. This project will no longer be updated or maintained. Customers us
Bot Framework Python SDK has reached end-of-life. This is the last planned release. This project will no longer be updated or maintained. Customers using this SDK will not be disrupted. However, the SDK will no longer be supported through service tickets in the Azure portal and will not receive product updates.
To build agents with your choice of AI services, orchestration, and knowledge, consider using the Microsoft 365 Agents SDK. The Agents SDK is GA and has support for C#, JavaScript or Python. You can learn more about the Agents SDK at aka.ms/agents. If you're looking for a SaaS-based agent platform, consider Microsoft Copilot Studio. If you have an existing bot built with the Bot Framework SDK, you can update your bot to the Agents SDK. You can review the core changes and updates at Bot Framework SDK to Agents SDK migration guidance here. Support tickets for the Bot Framework SDK will no longer be serviced as of December 31, 2025.
port: Add Teams read receipt event (#6356) by @gandiddi in https://github.com/microsoft/botbuilder-python/pull/2167
One column per quarter.
Full Changelog: https://github.com/microsoft/botbuilder-python/compare/4.16.2...4.17.0
Full Changelog: 4.16.2...4.17.0
Updated azure-cosmos to 4.7.0, requiring dropped support for obsolete…
Updated azure-cosmos to 4.7.0, requiring dropped support for obsolete…
This release contains a fix for a regression in allowing disabled auth for local testing, and fixes for certificate auth.
This release contains a fix for a regression in allowing disabled auth for local testing, and fixes for certificate auth.
This July release of the Bot Framework Python SDK contains support for User Assigned MSI.
This July release of the Bot Framework Python SDK contains support for User Assigned MSI.
The document Provision and publish a bot can be used for instructions. Note that this document has not been updated to indicate Python support, but either the C# or JS instructions will work.
Updated ARM templates for Python can be found at: https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/python/02.echo-bot/deploymentTemplates/deployUseExistResourceGroup
This is the June 2024 release of the Python Bot Framework SDK. This release contains security and other parity fixes.
This is the June 2024 release of the Python Bot Framework SDK. This release contains security and other parity fixes.
Full Changelog: https://github.com/microsoft/botbuilder-python/compare/4.15.0...4.15.1
This is the June 2024 release of the Python Bot Framework SDK. This release contains security and other parity fixes.
Full Changelog: 4.15.0...4.15.1
This is the April 2024 release of the Python Bot Framework SDK. This release contains Single Tenant support and security fixes.
This is the April 2024 release of the Python Bot Framework SDK. This release contains Single Tenant support and security fixes.
NOTE The aiohttp package version 3.9+ now require Python 3.8+. If your bot uses Python 3.7 or earlier, you will need to update to 3.8+. This would include updating the Python version in the App Service if deployed to Azure.
properties to ChannelAccount by @aacebo in https://github.com/microsoft/botbuilder-python/pull/2092Full Changelog: https://github.com/microsoft/botbuilder-python/compare/4.14.8...4.15.0
This is the April 2024 release of the Python Bot Framework SDK. This release contains Single Tenant support and security fixes.
NOTE
The aiohttp package version 3.9+ now require Python 3.8+. If your bot uses Python 3.7 or earlier, you will need to update to 3.8+. This would include updating the Python version in the App Service if deployed to Azure.
properties to ChannelAccount by Alex Acebo (@aacebo) in #2092Full Changelog: 4.14.8...4.15.0
This is the January 2024 patch release for Python.
This is the January 2024 patch release for Python.
Full Changelog: https://github.com/microsoft/botbuilder-python/compare/4.14.7...4.14.8
This is the January 2024 patch release for Python.
Full Changelog: 4.14.7...4.14.8
This is the December 2023 patch release for the Python SDK. It contains dependency updates, security fixes, and other minor fixes.
This is the December 2023 patch release for the Python SDK. It contains dependency updates, security fixes, and other minor fixes.
Full Changelog: https://github.com/microsoft/botbuilder-python/compare/4.14.6...4.14.7
This is the December 2023 patch release for the Python SDK. It contains dependency updates, security fixes, and other minor fixes.
Full Changelog: 4.14.6...4.14.7
This is the 4.14.6 release of the Pyhton SDK. This release corrects some CloudAdapter and Teams issues.
This is the 4.14.6 release of the Pyhton SDK. This release corrects some CloudAdapter and Teams issues.
We are happy to announce the deprecation of the Python SDK has been cancelled. The Python SDK will receive regular updates and support going forward.
This is the October 2023 release of the Python SDK. This release adds security and Python 3.11 changes.
We are happy to announce the deprecation of the Python SDK has been cancelled. The Python SDK will receive regular updates and support going forward.
Full Changelog: https://github.com/microsoft/botbuilder-python/compare/4.14.4...4.14.5
This is the May 2023 Python Bot Framework SDK release. This release focuses on dependency updates to resolve conflicts and security issues.
This is the May 2023 Python Bot Framework SDK release. This release focuses on dependency updates to resolve conflicts and security issues.
Changes:
Welcome to the October 2022 release of the Bot Framework Python SDK. This is a maintenance release to address security issues and notify of Python SDK
Welcome to the October 2022 release of the Bot Framework Python SDK. This is a maintenance release to address security issues and notify of Python SDK retirement.
The Bot Framework Python SDK is being retired with final long-term support ending in November 2023, after which this repository will be archived. There will be no further feature development, with only critical security and bug fixes within this repository being undertaken. Existing bots built with this SDK will continue to function. For all new bot development we recommend that you adopt Power Virtual Agents or use the Bot Framework C# or Bot Framework JavaScript SDKs.
For more information about the recommended approach to, and future of, bot building, please see https://powervirtualagents.microsoft.com/en-us/blog/the-future-of-bot-building/
Nothing published for this version
This is a maintenance release to correct an issue with OAuth in a Teams app.
This is a maintenance release to correct an issue with OAuth in a Teams app.
#1798 OAuthPrompt was constructing InvokeResponse incorrectly in some cases.
Deprecate HealthCheck Activity [[PR 1702]]
Welcome to the June 2021 release of the Bot Framework SDK. We are excited to introduce CloudAdapter (#1707) for botbuilder-python. Other new features include Microsoft Teams MeetingStart and MeetingEnd events (#1724), Get Meeting Info (#1704), Adaptive Card invoke adaptiveCard/action (#1697), and some bug fixes.
Nothing published for this version
Nothing published for this version
Welcome to the November 2020 release of the Bot Framework SDK. We continue to focus on code quality, improving developer experience, customer requests
Welcome to the November 2020 release of the Bot Framework SDK. We continue to focus on code quality, improving developer experience, customer requests, overall SDK improvements and partner support. We are previewing a new Cloud Adapter and other exciting things, including:
Insiders: Want to try new features as soon as possible? You can download the nightly Insiders build [C#] [JS] [Python] [CLI] and try the latest updates as soon as they are available. And for the latest Bot Framework news, updates, and content, follow us on Twitter @msbotframework!
Continued improvements enabling features for creating bots and apps in Teams.
To reduce development friction, you can now run and test skills locally with the Emulator without needing an AppId and password.
Quality for skills is critical, and we're making large invements in automated testing. That work is (mostly) still in the design phase, and feedback is very welcome:
We're also continuing to bring features to skills to enable additional scenarios:
Code quality and testing infrastructure have continued to be a focus for the this SDK release.
Updates and improvements to existing documentation have continued.
The Cloud Adapter introduces an enriched configuration model and enables hosting a bot in any cloud environment.
Orchestrator is a Language Understanding arbitration (“dispatch”) technology to route incoming user utterances to an appropriate skill or to subsequent language processing service such as LUIS or QnA Maker.
The Health Bot Service is a cloud platform for virtual health assistants and health bots, Health Bot uses Bot Framework under the hood. With the latest upgrade to the Bot Framework SDK V4 foundation, Health Bot can be called as a Bot Framework skill or call subsequent custom Bot Framework skills. See more here: Health Bot Overview.
Power Virtual Agents (PVA) is part of Microsoft Power Platform. In PVA, chatbots can be created with a guided, no-code graphical interface - and without the need for data scientists or developers. In the latest integration with Bot Framework SDK, PVA can be extended to create custom solutions.
Nothing published for this version
Welcome to the August 2020 release of the Bot Framework SDK. We are introducing some exciting Additional New Features with Updates and Enhancements. T
Welcome to the August 2020 release of the Bot Framework SDK. We are introducing some exciting Additional New Features with Updates and Enhancements. This milestone we focused on all-up quality and engineering debt, broken down across the following pillars:
Documentation Includes improvements to existing documentation and net new documentation centered on recurring issues and developer pain points.
Customer Supportability Improvements focused on developers seeking assistance using the Bot Framework, tools and SDKs.
Customer Ask Implemented enhancements and feature requests from the developer community and 3rd parties using the Bot Framework SDK and tools.
Code Quality Enforcement of code styling and format rules, increased testing code coverage, and functional tests.
Team Agility Improved validation of SDK code and integration with supporting libraries and environments. Continuous integarion and build pipleline improvements.
Insiders: Want to try new features as soon as possible? You can download the nightly Insiders build [C#] [JS] [Python] [CLI] and try the latest updates as soon as they are available. And for the latest Bot Framework news, updates, and content, follow us on Twitter @msbotframework!
Following feedback from customers and the Bot Framework Support Team, a number of net new documents have been written as well as updates to existing documentation. These are helpful towards providing answers and information relating to recurring issues from bot developers.
Developers using the Microsoft Bot Framework have many avenues for getting help. See additional resources Internal tools have been improved to increase the responsiveness of the engineering team in areas of most interest to developers.
GitHub repositoriesApplication Insights integrationGit Hub repositoriesConversationUpdateCardAction to support alt text for images on buttonsSkill Handler to return Resource ResponseAzure Blobs storageEntityImprovements have been made across SDK repositories towards decreased CI pipeline times, improved testing, including both functional integration and unit tests.
Lg added as core plugin, publish preview builds to npm, other improvementsTypescript samplesOAuthPrompt now support Teams SSOAdaptive Dialog support for Teams eventsChannelRestored, TeamArchived, TeamUnarchived,TeamRestored, TeamDeleted, and TeamHardDeletedInstallationUpdate activity type supportLinkToMessage added to MessageActionsPayloadLg added as BF-CLI core pluginlu parserQnaMaker support extendedbotframework-cli to npmConversationUpdate welcome message sampleTaskModule samples now includes HTML/JavaScript task modulesBot Framework Composer.See Composer 1.1.1 Release Notes
Orchestrator: Transformer based solution that runs locally with your bot to dispatch across one or more Bot Builder Skills or LUIS applications or QnA Maker Knowledgebase.
Microsoft.Bot.Builder.Azure.Queues (preview) Enables more easily interacting with Azure Queues and ContinueConversationLater Dialog. (Currently .NET only, coming soon to other languages)
Microsoft.Bot.Builder.Azure.Blobs BlobsStorage and BlobsTranscriptStore implementations replacing AzureBlobStorage and AzureBlobTranscriptStore. This library uses Azure.Storage.Blobs and is a replacement for the older Microsoft.Azure.Storage.Blob used by Microsoft.Bot.Builder.Azure. (Currently .NET only, coming soon to other languages)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Welcome to the May 2020 release of the Bot Framework SDK. There are a number of updates in this version that we hope you will like; some of the key hi
Welcome to the May 2020 release of the Bot Framework SDK. There are a number of updates in this version that we hope you will like; some of the key highlights include:
Insiders: Want to try new features as soon as possible? You can download the nightly Insiders build [C#] [JS] [Python] [CLI] and try the latest updates as soon as they are available. And for the latest Bot Framework news, updates, and content, follow us on Twitter @msbotframework!
Skills have been updated to work with adaptive dialogs, and both adaptive and traditional dialogs will now accept all types of activities.
The skill manifest schema has been updated to version 2.1. Improvements in this version include the ability to declare & share your language models, and define any type of activity that your skill can receive.
This release also includes authentication improvements with skills, including using SSO with dialogs, and OAuth without needing a magic code in WebChat and DirectLine.
We continue to focus on making sure all the Teams-specific APIs are fully supported across our SDKs. This release brings full support for Microsoft Teams APIs in the preview Java SDK, including samples.
The OnTeamsMemberAdded event in the activity handler has been updated to use the get single member endpoint under the covers, which should significantly reduce latency and reliability of this event in large teams.
The TeamsChannelAccount object has been updated to include userRole (one of owner, member, or guest) and tenantId (for the user's tenantId).
Bots now capture Page View events, native to Application Insights, whenever a dialog is started. This allows you to use the User Flows dashboard in Application Insights to see how users move through your bot, between dialogs and where they drop out.
Support was added for a new invoke named healthCheck that allows a sender to verify if a bot is responding to requests, and if trust can be established between the sender and the bot. The bot also has the option of overriding the response to add additional health information in the response.
We’re also excited to make Adaptive Dialogs generally available in C# and as a preview release in JavaScript!
Adaptive Dialogs, which underpin the dialog design and management authoring features found in Bot Framework Composer, enable developers to dynamically update conversation flow based on context and events. This is especially useful when dealing with more sophisticated conversation requirements, such as context switches and interruptions. Bot Framework Skills can now also leverage Adaptive Dialogs.
Adaptive Dialogs also now support Telemetry. Data from Adaptive Dialogs, including triggers, actions and recognizers now flow into your Azure Application Insights instance.
CLI tools for Adaptive Dialogs, Language Generation, QnaMaker and Luis Cross-train - new ability to merge and validate adaptive schema assets, augment qna and lu files, create/ update/ replace/ train/ publish LUIS and or QnA maker application and Language Generation templates manipulation.
New CLI Tools were added for management of Adaptive Dialogs.
LG is Generally Available (GA) on both the C# and JS Platforms.
Language Generation (LG) enables you to define multiple variations of a phrase, execute simple expressions based on context, and refer to conversational memory. At the core of language generation lies template expansion and entity substitution. You can provide one-off variation for expansion as well as conditionally expanding a template. The output from language generation can be a simple text string or multi-line response or a complex object payload that a layer above language generation will use to construct a complete activity. The Bot Framework Composer natively supports language generation to produce output activities using the LG templating system.
You can use Language Generation to:
Language Generation is achieved through:
Adaptive Expressions are Generally Available (GA) on both the C# and JS Platforms.
Bots use expressions to evaluate the outcome of a condition based on runtime information available in memory to the dialog or the Language Generation system. These evaluations determine how your bot reacts to user input and other factors that impact bot functionality.
Adaptive expressions were created to address this core need as well as provide an adaptive expression language that can used with the Bot Framework SDK and other conversational AI components, like Bot Framework Composer, Language Generation, Adaptive dialogs, and Adaptive Cards.
An adaptive expression can contain one or more explicit values, pre-built functions or [custom functions. Consumers of adaptive expressions also have the capability to inject additional supported functions. For example, all Language Generation templates are available as functions as well as additional functions that are only available within that component's use of adaptive expressions.
We added support for single sign-on while using Expect Replies. This applies to SSO performed between a pair of bots: host and a skill.
For Bot Identification we've added the ability to specify sendx5c parameter for certificate authentication. This feature was requested by customers and allows for more flexibility when using cert auth.
Additional Sovereign Clouds are supported.
The Bot Framework has a rich collection of conversational building blocks, but creating a bot that feels natural to converse with requires understanding and coordinating across language understanding, language generation and dialog management. To simplify this process and capture best practices, we've created the bf-generate plugin for the BotFramework CLI tool. The generated dialogs make use of event-driven adaptive dialogs with a rich and evolving set of capabilities including:
Adaptive tools is a brand new Visual studio code extension you can use to create/ validate .lu and .lg documents as well as debug declaratively defined adaptive dialogs. This extension provides rich authoring & editing capabilities for .lu and .lg file formats including syntax highlighting, auto-suggest and auto-complete.
We anticipate adding an early preview to the VS Marketplace shortly after this release.
During this release, the Bot Builder Community has further raised the bar by adding more features, more adapters, and fixing more bugs.
A revised C# Alexa Adapter and Google Home Adapter Re-built from the ground up, starting with Alexa, to allow the adapters to be consumed by Azure Bot Service and made available as channels. Improvements include better native activity type mapping, improved markdown rendering and support for more complex scenarios (such as merging multiple outgoing activities).
A new C# Zoom Adapter. Currently supports Zoom 1:1 and channel chat capabilities, being converted to native BF activity types. Also supports the subscribing to any event a Zoom as supports (translated into Event activities), with full support for Zoom interactive messages and rich message templates.
A RingCentral Adapter. The RingCentral Engage adapter allows you to add an additional endpoint to your bot for RingCentral Engage Digital Platform integration. The RingCentral endpoint can be used in conjunction with other channels meaning, for example, you can have a bot exposed on out of the box channels such as Facebook and Teams, but also integrated as an RingCentral Engage Digital Source SDK into RingCentral.
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release includes a fix for #596
This release includes a fix for #596
Welcome to the 4.7.0 release of the Bot Framework SDK for Python!
Welcome to the 4.7.0 release of the Bot Framework SDK for Python!
Bot Framework SDK for Python (GA) We are happy to announce the Bot Framework Python SDK is generally available and no longer a preview release.
Bot Framework SDK for Microsoft Teams (GA) The Bot Framework SDK v4.7.0 release fully integrates support for building Teams bots allowing users to use them in channel or group chat conversations. By adding a bot to a team or chat, all users of the conversation can take advantage of the bot functionality right in the conversation.
Welcome to the 4.5b5 release of the Bot Framework SDK for Python!
Welcome to the 4.5b5 release of the Bot Framework SDK for Python!
This version of the SDK breaks backwards compatibility at the storage layer to fix some broken edge-case scenarios. If a current bot uses the previous botbuilder-azure Cosmos or Blob storage classes this update might break read/write scenarios if the data model is class based. We recommend backing-up current stored data and have a migration strategy moving into this new version.
The issues list can be viewed here.
This minor release is a follow up to our launch of the Python Bot Framework, v4.5. It consists primarilty of bug fixes as well as working towards feat
This minor release is a follow up to our launch of the Python Bot Framework, v4.5. It consists primarilty of bug fixes as well as working towards feature parity with botbuilder-dotnet.
Review all changes that went into 4.5.0b4 in the detailed Change Log
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
After installing the botbuilder-core or botframework-connector, to use this release you need to run: `bash pip install git+https://github.com/Azure/ms
After installing the botbuilder-core or botframework-connector, to use this release you need to run:
pip install git+https://github.com/Azure/msrest-for-python.git@a997e97cd926c1eedfe4e5a3a52a637313fbd4e4
Rename BotContext to TurnContext (Breaking Change)
After installing the botbuilder-core or botframework-connector, to use this release you need to run:
pip install git+https://github.com/Azure/msrest-for-python.git@a997e97cd926c1eedfe4e5a3a52a637313fbd4e4
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →