Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Microsoft Agents Hosting FastAPI

This library provides FastAPI integration for Microsoft Agents, enabling you to build conversational agents using the FastAPI web framework.

Release Notes

Version Date Release Notes
1.9.0 2026-10-19 1.9.0 Release Notes
1.8.0 2026-10-01 1.8.0 Release Notes
1.7.0 2026-09-17 1.7.0 Release Notes
1.5.0 2026-08-26 1.5.0 Release Notes
1.4.0 2026-08-18 1.4.0 Release Notes
1.3.0 2026-07-30 1.3.0 Release Notes
1.2.0 2026-07-17 1.2.0 Release Notes
1.1.0 2026-06-19 1.1.0 Release Notes
1.0.0 2026-05-22 1.0.0 Release Notes
0.9.1 2026-05-04 0.9.1 Release Notes
0.9.0 2026-04-15 0.9.0 Release Notes
0.8.0 2026-02-23 0.8.0 Release Notes
0.7.0 2026-01-21 0.7.0 Release Notes
0.6.1 2025-12-01 0.6.1 Release Notes
0.6.0 2025-11-18 0.6.0 Release Notes

Packages Overview

We offer the following PyPI packages to create conversational experiences based on Agents:

Package Name PyPI Version Description
microsoft-agents-activity PyPI Types and validators implementing the Activity protocol spec.
microsoft-agents-hosting-core PyPI Core library for Microsoft Agents hosting.
microsoft-agents-hosting-aiohttp PyPI Configures aiohttp to run the Agent.
microsoft-agents-hosting-fastapi PyPI Configures fastapi to run the Agent.
microsoft-agents-hosting-msteams PyPI Provides classes to host an Agent for Teams.
microsoft-agents-hosting-dialogs PyPI Dialog system with waterfall dialogs, prompts, and multi-turn conversation management.
microsoft-agents-hosting-slack PyPI Provides classes to host an Agent for Slack.
microsoft-agents-storage-blob PyPI Extension to use Azure Blob as storage.
microsoft-agents-storage-cosmos PyPI Extension to use CosmosDB as storage.
microsoft-agents-authentication-msal PyPI MSAL-based authentication for Microsoft Agents.
microsoft-agents-authentication-entra-auth-sidecar PyPI Credential-free Entra ID Agent ID authentication via the sidecar.

Features

  • FastAPI integration for Microsoft Agents
  • JWT authorization middleware
  • Channel service API endpoints
  • Streaming response support
  • Cloud adapter for processing agent activities

Installation

pip install microsoft-agents-hosting-fastapi

Usage

from os import environ

from fastapi import FastAPI, Request
from microsoft_agents.activity import load_configuration_from_env
from microsoft_agents.authentication.msal import MsalConnectionManager
from microsoft_agents.hosting.core import MemoryStorage
from microsoft_agents.hosting.fastapi import (
    CloudAdapter,
    jwt_authorization_decorator,
    start_agent_process,
)
from microsoft_agents.hosting.core.app import AgentApplication

agents_sdk_config = load_configuration_from_env(environ)
app = FastAPI()
app.state.agent_configuration = agents_sdk_config
connection_manager = MsalConnectionManager(config=agents_sdk_config)
adapter = CloudAdapter(connection_manager=connection_manager)
agent_app = AgentApplication(
    connection_manager=connection_manager,
    storage=MemoryStorage(),
)

@app.post("/api/messages")
@jwt_authorization_decorator
async def messages(request: Request):
    return await start_agent_process(request, agent_app, adapter)

Metadata

Release files for microsoft-agents-hosting-fastapi 1.10.0.dev11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for microsoft-agents-hosting-fastapi 1.10.0.dev11
File Size Uploaded Provenance Actions
microsoft_agents_hosting_fastapi-1.10.0.dev11.tar.gz 8.8 kB Without provenance Details for microsoft_agents_hosting_fastapi-1.10.0.dev11.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for microsoft-agents-hosting-fastapi 1.10.0.dev11
File Interpreter ABI Platform Actions
microsoft_agents_hosting_fastapi-1.10.0.dev11-py3-none-any.whl Python 3 none any Details for microsoft_agents_hosting_fastapi-1.10.0.dev11-py3-none-any.whl

Total release size: 18.6 kB

Release files / microsoft_agents_hosting_fastapi-1.10.0.dev11.tar.gz

Download URL microsoft_agents_hosting_fastapi-1.10.0.dev11.tar.gz
Size 8.8 kB
Tags Source
SHA-256 checksum
How to use checksums
2e913f8772613f9e83a92dde92ba85a75e4ced352e44df7b9d6a1ca826b45978
BLAKE2b-256 checksum
How to use checksums
1cd0f3c67856cb408c8b0e853774b9c76df2f004d10ef65eec9af0ed6f9d41f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via RestSharp/106.13.0.0

Release files / microsoft_agents_hosting_fastapi-1.10.0.dev11-py3-none-any.whl

Download URL microsoft_agents_hosting_fastapi-1.10.0.dev11-py3-none-any.whl
Size 9.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
de62335cbf097f39adea30f7801f805dcf5e1e70fe262ddda4c0fa5bd8e8a9d5
BLAKE2b-256 checksum
How to use checksums
490c9fa01a630da84d68bae34584132a16c96fe53c4e53cbf81a1d16b6adcfaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via RestSharp/106.13.0.0

Security for microsoft-agents-hosting-fastapi 1.10.0.dev11

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page