microsoft/teams.py
Python
Captured source
source ↗microsoft/teams.py
Description: A suite of packages used to build on the Teams Platform.
Language: Python
License: MIT
Stars: 54
Forks: 24
Open issues: 10
Created: 2025-04-14T18:05:53Z
Pushed: 2026-06-10T19:12:18Z
Default branch: main
Fork: no
Archived: no
README: > [!NOTE] > Our Python SDK is now Generally Available!
Microsoft Teams SDK for Python
A comprehensive SDK for building Microsoft Teams applications, bots, and AI agents using Python. This SDK provides a high-level framework with built-in Microsoft Graph integration, OAuth handling, and extensible plugin architecture.
Questions & Issues
- Questions or Feature Requests: Please use GitHub Discussions
- Bug Reports: Please open an issue
- [Getting Started](#getting-started)
- [Packages](#packages)
- [Test Apps](#test-apps)
- [Links](#links)
Getting Started
Prerequisites
- UV version is >= 0.8.11. Install and upgrade from docs.astral.sh/uv.
- Python version is >= 3.11. Install or upgrade from python.org/downloads.
- (Optional) .NET SDK +
nbgvCLI for real version numbers. Without it, packages build as0.0.0which is fine for local development. See [RELEASE.md](RELEASE.md) for details.
Installation
1. Install the dependencies.
uv sync --all-packages --group dev
2. Activate the virtual env
> Note: After the initial setup, you need to activate the virtual environment each time you start a new terminal session
# On Mac `source .venv/bin/activate` # On Windows `.venv\Scripts\Activate`
3. Install the pre-commit hooks
pre-commit install
Packages
> ℹ️ core packages used to build client/server apps for Teams.
- [
microsoft-teams-apps](./packages/apps/README.md) - [
microsoft-teams-api](./packages/api/README.md) - [
microsoft-teams-cards](./packages/cards/README.md) - [
microsoft-teams-common](./packages/common/README.md) - [
microsoft-teams-graph](./packages/graph/README.md) - [
microsoft-teams-botbuilder](./packages/botbuilder/README.md)
Create a New Package
We use cookiecutter to create new packages. To create a new package, run:
cookiecutter templates/package -o packages
Follow the prompts to name the package and the directory. It should create the package folder in the packages directory.
Create A New Test Package
Similarly, to create a new test app, run:
cookiecutter templates/examples -o examples
Test Apps
> ℹ️ used to test the SDK or as a visual sample of how certain features can be implemented.
> ⚠️ WARNING these apps are changed often and are not intended to be used outside the > projects monorepo. To easily setup a new project please use the templates available via > the @microsoft/teams.cli and follow the > Getting Started documentation!
- [
@examples/echo](./examples/echo/README.md) - [
@examples/message-extensions](./examples/message-extensions/README.md) - [
@examples/dialogs](./examples/dialogs/README.md) - [
@examples/graph](./examples/graph/README.md) - [
@examples/stream](./examples/stream/README.md) - [
@examples/oauth](./examples/oauth/README.md) - [
@examples/meetings](./examples/meetings/README.md)
Links
Notability
notability 3.0/10New repo, low traction, routine.