{"id":13595725,"url":"https://github.com/microsoft/botbuilder-python","last_synced_at":"2026-01-05T21:19:46.259Z","repository":{"id":38802115,"uuid":"117021985","full_name":"microsoft/botbuilder-python","owner":"microsoft","description":"The Microsoft Bot Framework provides what you need to build and connect intelligent bots that interact naturally wherever your users are talking, from text/sms to Skype, Slack, Office 365 mail and other popular services.","archived":false,"fork":false,"pushed_at":"2025-04-16T12:33:44.000Z","size":8709,"stargazers_count":752,"open_issues_count":45,"forks_count":297,"subscribers_count":65,"default_branch":"main","last_synced_at":"2025-05-07T23:46:28.473Z","etag":null,"topics":["bot","bot-framework","bots","microsoft","microsoft-bot-framework","microsoft-cognitive-services","python"],"latest_commit_sha":null,"homepage":"http://botframework.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"Contributing.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-01-10T23:07:09.000Z","updated_at":"2025-04-30T09:32:19.000Z","dependencies_parsed_at":"2023-01-28T13:46:57.166Z","dependency_job_id":"b1b1854c-3177-411f-bb20-5b3b7bc458d2","html_url":"https://github.com/microsoft/botbuilder-python","commit_stats":{"total_commits":1296,"total_committers":99,"mean_commits":"13.090909090909092","dds":0.8233024691358024,"last_synced_commit":"fddd368dca2c0889c01cf4ac101666236aa9298b"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fbotbuilder-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fbotbuilder-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fbotbuilder-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fbotbuilder-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/botbuilder-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010803,"owners_count":21998993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","bot-framework","bots","microsoft","microsoft-bot-framework","microsoft-cognitive-services","python"],"created_at":"2024-08-01T16:01:56.416Z","updated_at":"2026-01-05T21:19:46.253Z","avatar_url":"https://github.com/microsoft.png","language":"Python","readme":"# ![Bot Framework SDK v4 Python](./doc/media/FrameWorkPython.png)\n\n# ARCHIVE NOTICE:\n\n\u003e We are in the process of archiving the Bot Framework Python SDK repository on GitHub. This means that this project will no longer be updated or maintained. Customers using this tool will not be disrupted. However, the tool will no longer be supported through \n\u003e service tickets in the Azure portal and will not receive product updates.\n\n\u003e To build agents with your choice of AI services, orchestration, and knowledge, consider using the [Microsoft 365 Agents SDK](https://github.com/microsoft/agents). 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](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/bf-migration-guidance). Support tickets for the Bot Framework SDK will no longer be serviced as of December 31, 2025.\n\n\u003e We plan to archive this project no later than end of December of 2025.\n\nThis repository contains code for the Python version of the [Microsoft Bot Framework SDK](https://github.com/Microsoft/botframework-sdk), which is part of the Microsoft Bot Framework - a comprehensive framework for building enterprise-grade conversational AI experiences.\n\nThis SDK enables developers to model conversation and build sophisticated bot applications using Python. SDKs for [JavaScript](https://github.com/Microsoft/botbuilder-js) and [.NET](https://github.com/Microsoft/botbuilder-dotnet) are also available.\n\nTo get started building bots using the SDK, see the [Azure Bot Service Documentation](https://docs.microsoft.com/en-us/azure/bot-service/?view=azure-bot-service-4.0).\n\nFor more information jump to a section below.\n\n* [Build status](#build-status)\n* [Packages](#packages)\n* [Getting started](#getting-started)\n* [Getting support and providing feedback](#getting-support-and-providing-feedback)\n* [Contributing and our code of conduct](contributing-and-our-code-of-conduct)\n* [Reporting security issues](#reporting-security-issues)\n\n## Build Status\n\n| Branch | Description        | Build Status | Coverage Status | Code Style |\n |----|---------------|--------------|-----------------|--|\n| Main | 4.17.0 Builds | [![Build Status](https://fuselabs.visualstudio.com/SDK_v4/_apis/build/status/Python/Python-CI-PR-yaml?branchName=main)](https://fuselabs.visualstudio.com/SDK_v4/_build/latest?definitionId=771\u0026branchName=main) | [![Coverage Status](https://coveralls.io/repos/github/microsoft/botbuilder-python/badge.svg?branch=HEAD)](https://coveralls.io/github/microsoft/botbuilder-python?branch=HEAD) | [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) |\n\n## Packages\n\n| Build | Released Package |\n |----|---------------|\n| botbuilder-ai | [![PyPI version](https://badge.fury.io/py/botbuilder-ai.svg)](https://pypi.org/project/botbuilder-ai/) |\n| botbuilder-applicationinsights | [![PyPI version](https://badge.fury.io/py/botbuilder-applicationinsights.svg)](https://pypi.org/project/botbuilder-applicationinsights/) |\n| botbuilder-azure | [![PyPI version](https://badge.fury.io/py/botbuilder-azure.svg)](https://pypi.org/project/botbuilder-azure/) |\n| botbuilder-core | [![PyPI version](https://badge.fury.io/py/botbuilder-core.svg)](https://pypi.org/project/botbuilder-core/) |\n| botbuilder-dialogs | [![PyPI version](https://badge.fury.io/py/botbuilder-dialogs.svg)](https://pypi.org/project/botbuilder-dialogs/) |\n| botbuilder-schema | [![PyPI version](https://badge.fury.io/py/botbuilder-schema.svg)](https://pypi.org/project/botbuilder-schema/) |\n| botframework-connector | [![PyPI version](https://badge.fury.io/py/botframework-connector.svg)](https://pypi.org/project/botframework-connector/) |\n|\n\n## Getting Started\nTo get started building bots using the SDK, see the [Azure Bot Service Documentation](https://docs.microsoft.com/en-us/azure/bot-service/?view=azure-bot-service-4.0).\n\nThe [Bot Framework Samples](https://github.com/microsoft/botbuilder-samples) includes a rich set of samples repository.\n\nIf you want to debug an issue, would like to [contribute](#contributing-code), or understand how the Bot Builder SDK works, instructions for building and testing the SDK are below.\n\n### Prerequisites\n- [Git](https://git-scm.com/downloads)\n- [Python 3.8.17 - 3.11.x](https://www.python.org/downloads/)\n\nPython \"Virtual Environments\" allow Python packages to be installed in an isolated location for a particular application, rather than being installed globally, as such it is common practice to use them. Click [here](https://packaging.python.org/tutorials/installing-packages/#creating-virtual-environments) to learn more about creating _and activating_ Virtual Environments in Python.\n\n### Clone\nClone a copy of the repo:\n```bash\ngit clone https://github.com/Microsoft/botbuilder-python.git\n```\nChange to the SDK's directory:\n```bash\ncd botbuilder-python\n```\n\n### Using the SDK locally\n\nTo use a local copy of the SDK you can link to these packages with the pip -e option.\n\n```bash\npip install -e ./libraries/botbuilder-schema\npip install -e ./libraries/botframework-connector\npip install -e ./libraries/botframework-streaming\npip install -e ./libraries/botbuilder-core\npip install -e ./libraries/botbuilder-ai\npip install -e ./libraries/botbuilder-applicationinsights\npip install -e ./libraries/botbuilder-dialogs\npip install -e ./libraries/botbuilder-azure\npip install -e ./libraries/botbuilder-integration-applicationinsights-aiohttp\npip install -e ./libraries/botbuilder-adapters-slack\npip install -e ./libraries/botbuilder-integration-aiohttp\npip install -e ./libraries/botbuilder-testing\n```\n\n### Running unit tests\nFirst execute the following command from the root level of the repo:\n```bash\npip install -r ./libraries/botframework-connector/tests/requirements.txt\npip install -r ./libraries/botbuilder-core/tests/requirements.txt\npip install -r ./libraries/botbuilder-ai/tests/requirements.txt\n```\n\nThen enter run pytest by simply typing it into your CLI:\n\n```bash\npytest\n```\n\nThis is the expected output:\n```bash\n============================= test session starts =============================\nplatform win32 -- Python 3.8.2, pytest-3.4.0, py-1.5.2, pluggy-0.6.0\nrootdir: C:\\projects\\botbuilder-python, inifile:\nplugins: cov-2.5.1\n...\n```\n\n## Getting support and providing feedback\nBelow are the various channels that are available to you for obtaining support and providing feedback. Please pay carful attention to which channel should be used for which type of content. e.g. general \"how do I...\" questions should be asked on Stack Overflow, Twitter or Gitter, with GitHub issues being for feature requests and bug reports.\n\n### Github issues\n[Github issues](https://github.com/Microsoft/botbuilder-python/issues) should be used for bugs and feature requests.\n\n### Stack overflow\n[Stack Overflow](https://stackoverflow.com/questions/tagged/botframework) is a great place for getting high-quality answers. Our support team, as well as many of our community members are already on Stack Overflow providing answers to 'how-to' questions.\n\n### Azure Support\nIf you issues relates to [Azure Bot Service](https://azure.microsoft.com/en-gb/services/bot-service/), you can take advantage of the available [Azure support options](https://azure.microsoft.com/en-us/support/options/).\n\n### Twitter\nWe use the [@msbotframework](https://twitter.com/msbotframework) account on twitter for announcements and members from the development team watch for tweets for [@msbotframework](https://twitter.com/msbotframework).\n\n### Gitter Chat Room\nThe [Gitter Channel](https://gitter.im/Microsoft/BotBuilder) provides a place where the Community can get together and collaborate.\n\n## Contributing and our code of conduct\nWe welcome contributions and suggestions. Please see our [contributing guidelines](./Contributing.md) for more information.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\n\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact\n [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n### Contributing Code\n\nIn order to create pull requests, submitted code must pass ```pylint``` and ```black``` checks.  Run both tools on every file you've changed.\n\nFor more information and installation instructions, see:\n\n* [black](https://pypi.org/project/black/)\n* [pylint](https://pylint.org/)\n\n## Reporting Security Issues\nSecurity issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC)\nat [secure@microsoft.com](mailto:secure@microsoft.com).  You should receive a response within 24 hours.  If for some\n reason you do not, please follow up via email to ensure we received your original message. Further information,\n including the [MSRC PGP](https://technet.microsoft.com/en-us/security/dn606155) key, can be found in the\n[Security TechCenter](https://technet.microsoft.com/en-us/security/default).\n\nCopyright (c) Microsoft Corporation. All rights reserved.\n\nLicensed under the [MIT](./LICENSE) License.\n\n\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fbotbuilder-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fbotbuilder-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fbotbuilder-python/lists"}