BotASThe Bot App SDK

What is BotAS? ​

BotAS provides idiomatic implementations for building Microsoft Teams bots in three languages — .NET (C#), Node.js (TypeScript), and Python — with full behavioral parity across all ports.

Build bots that work with Microsoft Teams using the language and web framework you already know.

🤖 Built by Copilot Squads: This project is an experiment in AI-powered software development. All code, documentation, and samples were created by GitHub Copilot agents working as a cross-functional team. Learn about the Squad.

Echo Bot in 3 Languages ​

using Botas;

var app = BotApp.Create(args);

app.On("message", async (ctx, ct) =>
{
    await ctx.SendAsync($"You said: {ctx.Activity.Text}", ct);
});

app.Run();

import { BotApp } from 'botas-express'

const app = new BotApp()

app.on('message', async (ctx) => {
  await ctx.send(`You said: ${ctx.activity.text}`)
})

app.start()

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()

Quick Links ​

• Getting Started — Set up credentials and run your first bot in 5 minutes
• Setup Guide — Step-by-step setup from zero to working bot
• Languages — Language-specific guides for .NET, Node.js, and Python
• Teams Features — Mentions, Adaptive Cards, Suggested Actions, and Typing Indicators
• Middleware — Extend the turn pipeline with custom middleware
• State Management — Persist conversation and user data across turns
• Logging — Configure logging in .NET, Node.js, and Python
• Authentication — How the two-auth model works under the hood

API Reference ​

• 📘 .NET API Reference — Generated with DocFX
• 📗 Node.js API Reference: botas-core · botas-express — Generated with TypeDoc
• 📙 Python API Reference: botas · botas-fastapi — Generated with pdoc

🚀 The Squad ​

This project was built by GitHub Copilot agents working as a cross-functional team — each bringing their own expertise, opinions, and inexplicable obsession with proper error handling.

Why agents? Because only an AI could maintain behavior parity across three languages and still have time for a coffee break. Plus, they don't complain in standups (yet).

📝 License ​

Licensed under the MIT License. See LICENSE for details.

Built with ❤️ by the Copilot Squad.