botas

A lightweight, multi-language library for building Microsoft Teams bots — this is the core Python package.

For zero-boilerplate FastAPI hosting, see botas-fastapi.

Installation

pip install botas

Quick start (with FastAPI)

from botas import BotApplication
from botas_fastapi import bot_auth_dependency
from fastapi import Depends, FastAPI, Request

bot = BotApplication()

@bot.on("message")
async def on_message(ctx):
    await ctx.send(f"You said: {ctx.activity.text}")

app = FastAPI()

@app.post("/api/messages", dependencies=[Depends(bot_auth_dependency())])
async def messages(request: Request):
    body = await request.body()
    await bot.process_body(body.decode())
    return {}

Or use the higher-level botas-fastapi wrapper for a simpler setup:

from botas_fastapi import BotApp

app = BotApp()

@app.on("message")
async def on_message(ctx):
    await ctx.send(f"You said: {ctx.activity.text}")

app.start()

API

`BotApplication`

The core bot class — web-framework-agnostic.

Method	Description
`on(type, handler)`	Register a handler for an activity type (also works as a `@decorator`)
`on_invoke(name, handler)`	Register a handler for an invoke activity by name (also works as a `@decorator`)
`use(middleware)`	Add a middleware to the turn pipeline (runs in registration order)
`process_body(body)`	Process a raw JSON body string

Authentication options

BotApplicationOptions fields (also resolved from environment variables):

Option	Env variable	Description
`client_id`	`CLIENT_ID`	Azure AD application (bot) ID
`client_secret`	`CLIENT_SECRET`	Azure AD client secret
`tenant_id`	`TENANT_ID`	Azure AD tenant ID (default: `common`)
`managed_identity_client_id`	`MANAGED_IDENTITY_CLIENT_ID`	Managed identity client ID
`token_factory`	—	Custom async token factory `(scope, tenant_id) -> str`

Documentation

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

botas-0.3.83.tar.gz (36.9 kB view details)

Uploaded May 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

botas-0.3.83-py3-none-any.whl (30.1 kB view details)

Uploaded May 2, 2026 Python 3

File details

Details for the file botas-0.3.83.tar.gz.

File metadata

Download URL: botas-0.3.83.tar.gz
Upload date: May 2, 2026
Size: 36.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for botas-0.3.83.tar.gz
Algorithm	Hash digest
SHA256	`8b40ef00895e3afcbd838a0566d2760cf867ca4dcfb42dd5f7faf00fcdfb1b91`
MD5	`2798cb3209613410437a4c7f4be26873`
BLAKE2b-256	`87337a9daf650dc6046874a0e03b39347f08edb8874201ad7a255c8590957bdb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for botas-0.3.83.tar.gz:

Publisher: CD.yml on rido-min/botas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: botas-0.3.83.tar.gz
- Subject digest: 8b40ef00895e3afcbd838a0566d2760cf867ca4dcfb42dd5f7faf00fcdfb1b91
- Sigstore transparency entry: 1429597050
- Sigstore integration time: May 2, 2026
Source repository:
- Permalink: rido-min/botas@28e3385c46324f5241c9f7696b71d6ae65971136
- Branch / Tag: refs/tags/v0.3.83
- Owner: https://github.com/rido-min
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: CD.yml@28e3385c46324f5241c9f7696b71d6ae65971136
- Trigger Event: push