---
id: microsoft-agents-hosting-aiohttp
version: "1.3.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# microsoft-agents-hosting-aiohttp — Integration library for Microsoft Agents with aiohttp

License: permissive · Maintenance: active · Downloads: 237.0K/mo

## What it is and what it does

This package bridges the Microsoft 365 Agents SDK with aiohttp, a popular async HTTP framework for Python. It provides HTTP adapters, middleware, and utilities to host conversational agents as web services, handling the plumbing needed to expose agent logic over HTTP endpoints. The library integrates with the core hosting framework and aiohttp to manage request routing, authentication via JWT middleware, and agent-to-agent communication.

You use it when you want to deploy a Microsoft 365 Agent as a web service—whether for Teams, M365 Copilot, Copilot Studio, or custom web chat. It abstracts away the HTTP layer details so you can focus on agent logic: define message handlers, error handlers, and storage, then call `start_server()` to run the aiohttp application. The package supports streaming responses, custom error handling, and development-friendly features like hot reload.

Use it for:

- Host a Microsoft Teams agent as an HTTP service that receives and responds to conversation activities.
- Build a web chat interface backed by a Microsoft 365 Agent with real-time streaming responses.
- Integrate a Copilot Studio Agent with aiohttp for custom routing and middleware (e.g., logging, rate limiting).
- Deploy multi-agent systems where agents communicate via HTTP with JWT authentication.
- Create a development environment for agent testing with hot reload and debugging support.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides HTTP hosting integration for Microsoft 365 Agents using aiohttp, enabling you to build web-based agent applications with request processing, authentication, and routing.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and solves a clear problem: hosting Microsoft 365 Agents over HTTP with aiohttp. It is well-positioned in the Microsoft Agents ecosystem and has no known vulnerabilities. Install it if you are building a web-based agent application and prefer aiohttp over other frameworks.

## Install

pip install microsoft-agents-hosting-aiohttp
uv add microsoft-agents-hosting-aiohttp
poetry add microsoft-agents-hosting-aiohttp

## Installing microsoft-agents-hosting-aiohttp

Before you install: Low friction install with two runtime dependencies. Package is actively maintained with releases every 1–2 weeks; repository shows 1036 stars and recent activity as of 2026-08-13.

License in practice: MIT license permits commercial and private use with minimal restrictions; you must include the license notice in distributions.

Quickstart:

pip install microsoft-agents-hosting-aiohttp

from microsoft_agents_hosting_aiohttp import start_server
from microsoft_agents_hosting_core import AgentApplication

start_server(
    agent_application=AGENT_APP,
    auth_configuration=CONNECTION_MANAGER.get_default_connection_configuration(),
)

Requires Python 3.10 or later; aiohttp 3.11.11+ is required.

Verify before relying:

- Whether aiohttp 3.11.11+ is a hard requirement or if earlier versions are supported
- Whether the package handles graceful shutdown of the aiohttp server
- Performance characteristics under load or with streaming responses

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 237.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aiohttp agent hosting, microsoft agents web framework, conversational ai http server, agent middleware authentication, microsoft 365 agents integration, async agent application framework, agent activity routing, conversational-ai, async-http, microsoft-agents

[View on SkillFed](https://skillfed.io/packages/microsoft-agents-hosting-aiohttp) · [View on PyPI](https://pypi.org/project/microsoft-agents-hosting-aiohttp/)