Caution
This project is in active development and not ready for production use. It has not been publicly announced yet.
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.
- UV version is >= 0.8.11. Install and upgrade from docs.astral.sh/uv.
- Python version is >= 3.12. Install or upgrade from python.org/downloads.
uv sync --all-packages --group dev
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`
pre-commit install
ℹ️ core packages used to build client/server apps for Teams.
microsoft-teams-apps
microsoft-teams-ai
microsoft-teams-api
microsoft-teams-cards
microsoft-teams-common
microsoft-teams-devtools
microsoft-teams-graph
microsoft-teams-openai
external packages to integrate with external protocols and microsoft-teams-cards
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.
Similarly, to create a new test package, run:
cookiecutter templates/test -o tests
ℹ️ 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!