botas 0.2.3

Lightweight library for building Microsoft Bot Framework bots - Python

botas

Lightweight library for building Microsoft Bot Framework bots — Python.

What it does

• Validates inbound JWT tokens from the Bot Framework Service
• Deserializes activities and dispatches them to registered handlers
• Runs a configurable middleware pipeline before each handler
• Authenticates outbound HTTP calls using OAuth2 client credentials
• Preserves unknown JSON properties so custom channel data round-trips safely

Installation

pip install botas

Quick start

from botas import BotApp

app = BotApp()

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

app.start()

Environment variables

Variable	Description
CLIENT_ID	Azure AD application (bot) ID
CLIENT_SECRET	Azure AD client secret
TENANT_ID	Azure AD tenant ID (or common)
PORT	HTTP listen port (default: 3978)

Documentation

• Full documentation site
• Full feature specification
• Architecture overview
• Infrastructure setup

License

MIT