microsoft-agents-hosting-core
Core library for Microsoft Agents
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides low-friction installation. It is the required foundation for any Microsoft 365 agent development in Python. Install it if you are building agents for Teams, M365 Copilot, or other Microsoft platforms; skip it if you need agents for non-Microsoft channels only.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; also requires a hosting adapter (aiohttp, FastAPI, or Teams) and authentication configuration to run a complete agent.
- Low install friction with a pure-Python wheel distribution.
- The package is actively maintained with a recent release (15 days old) and steady commit activity.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.
last release 2026-07-30 (15 days) · last repo commit 2026-08-13 · 1,036 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 938,513 downloads/mo, #4,685 on PyPI
Alternatives
Verify before relying
pip install microsoft-agents-hosting-core
from microsoft_agents_hosting_core import AgentApplication, TurnContext, TurnState
from microsoft_agents_activity import MemoryStorage
STORAGE = MemoryStorage()
AGENT_APP = AgentApplication[TurnState](storage=STORAGE)
@AGENT_APP.activity("message")
async def on_message(context: TurnContext, state: TurnState):
await context.send_activity(f"You said: {context.activity.text}")- Whether the package requires Azure credentials or Microsoft 365 tenant setup to function beyond basic examples
- Performance characteristics and scalability limits for concurrent agent instances
- Compatibility with third-party channel integrations (Slack, Facebook, Twilio) mentioned in description but not detailed in core library scope
What it is and what it does
microsoft-agents-hosting-core is the foundational library for the Microsoft 365 Agents SDK, providing the orchestration engine for building production-grade conversational agents. It supplies the core classes (AgentApplication, TurnContext, TurnState) and infrastructure for activity routing, multi-turn conversation state, and channel communication. The library handles the complex plumbing of agent lifecycle management, state persistence across conversation turns, and integration with authentication systems.
Developers use it to build agents that respond to messages through decorator-based routing, manage conversation state across turns, and handle errors consistently. It depends on microsoft-agents-activity for the Activity protocol types, pyjwt for token handling, python-dotenv for configuration, and opentelemetry for observability. The library is designed to work with hosting adapters (aiohttp, FastAPI, Teams, Slack) that you install separately depending on your deployment target.
Use it for
- Build a Teams bot that maintains conversation state and routes messages to handler functions based on content patterns
- Create a multi-platform agent that handles the same business logic across Teams, Slack, and web chat with unified state management
- Implement enterprise-grade error handling and observability for production agents using OpenTelemetry integration
- Develop agents with role-based authorization and authentication using the built-in Authorization and ClaimsIdentity classes
- Manage complex multi-turn conversations with ConversationState, UserState, and TempState across different scopes
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides low-friction installation. It is the required foundation for any Microsoft 365 agent development in Python. Install it if you are building agents for Teams, M365 Copilot, or other Microsoft platforms; skip it if you need agents for non-Microsoft channels only.
Install
microsoft-agents-hosting-core on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. The package is actively maintained with a recent release (15 days old) and steady commit activity. Dependencies are standard (JWT, ISO date parsing, environment config, observability) with no compiled components.
Requires Python 3.10 or later; also requires a hosting adapter (aiohttp, FastAPI, or Teams) and authentication configuration to run a complete agent.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.
Quickstart
pip install microsoft-agents-hosting-core
from microsoft_agents_hosting_core import AgentApplication, TurnContext, TurnState
from microsoft_agents_activity import MemoryStorage
STORAGE = MemoryStorage()
AGENT_APP = AgentApplication[TurnState](storage=STORAGE)
@AGENT_APP.activity("message")
async def on_message(context: TurnContext, state: TurnState):
await context.send_activity(f"You said: {context.activity.text}")Verify before relying
- Whether the package requires Azure credentials or Microsoft 365 tenant setup to function beyond basic examples
- Performance characteristics and scalability limits for concurrent agent instances
- Compatibility with third-party channel integrations (Slack, Facebook, Twilio) mentioned in description but not detailed in core library scope
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesmicrosoft-agents-activitypyjwtisodatepython-dotenvopentelemetry-apiopentelemetry-sdk |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 938,513 / month, #4,685 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Operating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: microsoft_agents_hosting_core-1.3.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “teams bot hosting library”
- microsoft-agents-hosting-coreProvides the core hosting infrastructure for building conversational…
- microsoft-agents-activityProvides core types and schemas implementing the Activity protocol…
- microsoft-agents-hosting-teamsProvides Teams-specific handlers and utilities for building Microsoft…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also microsoft-agents-activity · microsoft-agents-hosting-aiohttp · microsoft-agents-hosting-fastapi · microsoft-agents-hosting-teams · microsoft-agents-authentication-msal · microsoft-agents-copilotstudio-client · microsoft-teams-apps · agent-framework-core · agent-framework · microsoft-agents-a365-runtime