---
id: agent-framework
version: "1.14.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# agent-framework — Microsoft Agent Framework for building AI Agents with Python. This package contains all the core and optional packages.

License: permissive · Maintenance: active · Downloads: 1.5M/mo

## What it is and what it does

Agent Framework is Microsoft's Python library for building and coordinating AI agents that interact with large language models. It provides a high-level Agent class that wraps OpenAI and Azure OpenAI chat clients, allowing you to define agent behavior through instructions, attach tools for function calling, and compose multiple agents into orchestrated workflows. The framework handles async execution, message passing, and agent-to-agent handoff patterns out of the box.

The package is designed for both simple single-agent tasks (summarization, Q&A) and complex multi-agent scenarios (sequential workflows, concurrent execution, group chat). It abstracts away boilerplate LLM integration code and provides patterns for common orchestration use cases like writer-reviewer loops and specialized agent teams. Installation is straightforward—either install the full framework with all integrations or pick specific sub-packages (core, foundry, copilotstudio) to keep dependencies lean.

Use it for:

- Build a single agent that summarizes documents or answers questions using OpenAI or Azure OpenAI as the backbone.
- Create a multi-agent workflow where specialized agents (e.g., writer, reviewer, editor) collaborate sequentially or in parallel to refine content.
- Attach custom Python functions as tools to agents so they can call weather APIs, database queries, or other services during execution.
- Orchestrate agent handoff patterns where one agent routes tasks to another based on expertise or context.
- Integrate with Microsoft Foundry or Copilot Studio for enterprise LLM and workflow management.

## Worth the install?

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

Builds and orchestrates AI agents powered by OpenAI and Azure OpenAI APIs, with support for multi-agent workflows, tool calling, and agent-to-agent collaboration patterns.

Yes. The package is actively maintained, production-stable, has no known vulnerabilities, and offers low install friction. It's a solid choice if you're building AI agents on OpenAI or Azure OpenAI and want structured orchestration patterns without writing boilerplate. The permissive MIT license and broad Python version support (3.10–3.14) add to its appeal. Start with a single agent to validate your use case, then scale to multi-agent workflows as needed.

## Install

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

## Installing agent-framework

Before you install: Active maintenance with recent release; low install friction as a pure Python wheel with a single core dependency. Supports Python 3.10 through 3.14 and shows strong adoption (top 5000 PyPI by downloads).

License in practice: MIT license (permissive) allows unrestricted use, modification, and distribution in commercial and private projects.

Quickstart:

pip install agent-framework

import asyncio
from agent_framework import Agent
from agent_framework.openai import OpenAIChatClient

async def main():
    agent = Agent(
        client=OpenAIChatClient(),
        instructions="You are a helpful assistant."
    )
    result = await agent.run("Your prompt here")
    print(result)

asyncio.run(main())

Requires Python 3.10+. Requires OpenAI or Azure OpenAI API credentials set as environment variables (OPENAI_API_KEY or AZURE_OPENAI_API_KEY, etc.).

Verify before relying:

- Whether agent-framework-core and integration packages (foundry, copilotstudio) are included in the main agent-framework install or require separate installation.
- Specific performance characteristics or limits for multi-agent orchestration (e.g., concurrent agent scaling, latency).
- Whether the framework supports non-OpenAI LLM providers beyond Azure OpenAI.

## Package facts

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

## Tags

ai agent framework python, multi-agent orchestration, openai agent builder, llm agent framework, agentic workflow orchestration, python agent tools, agent framework azure openai, multi-agent-orchestration, llm-integration, async-framework

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