agent-framework-foundry-hosting

What it is and what it does

Agent-framework-foundry-hosting bridges Microsoft's Agent Framework with the Foundry Agent Server, enabling agents and workflows to run on Foundry-hosted infrastructure. It provides three durable state stores out of the box: FoundryAgentSessionStore (for Agent Framework sessions), FoundryCheckpointStore (for workflow checkpoints), and FoundryFunctionApprovalStore (for function approvals). When hosted on Foundry, all state is automatically isolated by platform user ID—no manual partitioning needed. Outside Foundry, state persists as JSON files locally under ~/.agentserver/state_stores.

The package depends on agent-framework-core, three azure-ai-agentserver modules (core, responses, invocations), httpx, and mcp. It's in beta (1.0.0b260813) but actively maintained, with support for Python 3.10 through 3.14. The permissive license and low install friction make it straightforward to add to an Agent Framework project that targets Foundry deployment.

Use it for:

• Deploy Agent Framework agents to Foundry infrastructure with automatic durable session and checkpoint storage.
• Build multi-user agent applications where session data must be isolated by platform user ID without custom partitioning logic.
• Persist workflow checkpoints across agent restarts to enable long-running, resumable workflows.
• Manage function approval workflows with durable storage that works both locally (file-based) and on Foundry (cloud-backed).
• Develop agents locally using file-based state stores, then deploy the same code to Foundry with zero storage configuration changes.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Integrates Agent Framework agents and workflows with the Foundry Agent Server, providing durable state persistence (sessions, checkpoints, approvals) with automatic user isolation when hosted on Foundry infrastructure.

Yes, if you are building agents with Microsoft's Agent Framework and plan to deploy to Foundry infrastructure. The package is actively maintained, has no known vulnerabilities, and provides essential durable state management with automatic user isolation. The beta status and recent release date (2026-08-14) suggest it is still evolving; review the sample code and state-store guide before committing to production use.

Install

agent-framework-foundry-hosting on PyPI

pip install agent-framework-foundry-hosting

uv add agent-framework-foundry-hosting

poetry add agent-framework-foundry-hosting

Installing agent-framework-foundry-hosting

Before you install

Active maintenance with a recent release (2026-08-14) and low install friction. Depends on six runtime packages including agent-framework-core and azure-ai-agentserver components, all from the same ecosystem.

License in practice

Licensed permissively, allowing broad use and modification without restrictive obligations.

Quickstart

pip install agent-framework-foundry-hosting

from agent_framework_foundry_hosting import ResponsesHostServer

# ResponsesHostServer persists Agent Framework sessions durably
server = ResponsesHostServer()

Requires Python 3.10 or later. Local state persistence writes to ~/.agentserver/state_stores by default; set AGENTSERVER_STATE_ROOT environment variable to customize the root directory.

Verify before relying

• Whether ResponsesHostServer is the primary entry point or if other hosting classes are commonly used.
• What configuration is required to connect to actual Foundry infrastructure (vs. local file-based fallback).
• Performance characteristics or limits for concurrent agent sessions or checkpoint sizes.

Package facts

Evidence: agent_framework_foundry_hosting-1.0.0b260813-py3-none-any.whl

Tags

More Application Frameworks packages

Further reading