---
id: agent-framework-foundry-hosting
version: "1.0.0b260813"
license: unclear
license_treatment: permissive
maintenance: active
---

# agent-framework-foundry-hosting — Foundry Hosting integration for Microsoft Agent Framework.

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

## 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 above — 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

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

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

## Tags

agent framework foundry hosting, durable state store agent sessions, foundry agent server integration, workflow checkpoint persistence, function approval store, multi-user agent isolation, agent framework deployment, agent-framework, foundry-hosting, durable-state

[View on SkillFed](https://skillfed.io/packages/agent-framework-foundry-hosting) · [View on PyPI](https://pypi.org/project/agent-framework-foundry-hosting/)