---
id: agent-framework-foundry-local
version: "1.0.0b260730"
license: unclear
license_treatment: permissive
maintenance: active
---

# agent-framework-foundry-local — Foundry Local integration for Microsoft Agent Framework.

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

## What it is and what it does

This package provides local Foundry integration for Microsoft Agent Framework, a framework designed to build production-grade AI agents and multi-agent workflows in Python. It acts as a bridge between the core Agent Framework and Microsoft Foundry's local development environment, allowing developers to prototype and test agents locally before deploying to production. The package depends on agent-framework-core, agent-framework-openai, and foundry-local-sdk to provide orchestration, LLM connectivity, and local Foundry access.

The framework supports graph-based orchestration patterns (sequential, concurrent, handoff, group collaboration), middleware for request/response processing, built-in observability via OpenTelemetry, and human-in-the-loop control. It is aimed at teams moving agents from prototype to production and is designed to remain architecture-agnostic as requirements evolve, supporting a broad ecosystem including Azure OpenAI, OpenAI, and GitHub Copilot SDK.

Use it for:

- Local development and testing of AI agents before deploying to production infrastructure.
- Building multi-agent workflows with orchestration patterns like sequential execution, concurrent tasks, and agent handoffs.
- Prototyping agents with Foundry Local as the LLM provider while maintaining compatibility with production cloud deployments.
- Integrating observability and monitoring into agent systems using built-in OpenTelemetry support.
- Implementing human-in-the-loop workflows where agents can pause for human review or intervention.

## Worth the install?

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

Integrates Microsoft Agent Framework with Foundry Local, enabling local development and testing of production-grade AI agents and multi-agent workflows using Microsoft Foundry as the LLM provider.

Yes, with conditions. The package is actively maintained, has low install friction, and is MIT-licensed. It is in beta status and depends on three other agent-framework packages, so verify that your environment can accommodate those dependencies and that Foundry Local is available for your use case. No known vulnerabilities. Install if you are building agents with Microsoft Agent Framework and need local Foundry integration for development.

## Install

pip install agent-framework-foundry-local
uv add agent-framework-foundry-local
poetry add agent-framework-foundry-local

## Installing agent-framework-foundry-local

Before you install: Low install friction with a pure-Python wheel and only three runtime dependencies. The package is actively maintained with recent releases and a large repository (12804 stars), though it is still in beta status.

License in practice: Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install agent-framework-foundry-local

from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient

agent = Agent(
    client=FoundryChatClient(),
    name="MyAgent",
    instructions="You are a helpful assistant."
)
result = await agent.run("Your prompt here")

Requires Python 3.10 or later; Foundry Local credentials and endpoint configuration must be available (typically via environment variables or direct constructor parameters).

Verify before relying:

- Whether this package can be used standalone or requires the full agent-framework package to be installed separately.
- Whether Foundry Local is a free offering or requires a paid subscription.
- Performance characteristics and scalability limits for concurrent agent workflows.
- Specific version compatibility between agent-framework-foundry-local and its three runtime dependencies.

## Package facts

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

## Tags

agent framework foundry local, microsoft agent framework integration, local ai agent development, foundry local sdk agents, multi-agent workflow orchestration, production ai agent framework, agent framework llm provider, ai-agents, multi-agent-orchestration, foundry-integration

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