ag2

What it is and what it does

AG2 is a protocol-driven framework for building AI agents and coordinating multiple agents to solve tasks. It replaces the earlier AutoGen Classic framework (now maintained separately as ag2-classic) with a new agent model centered on async-first design, a Network-based orchestration pattern for multi-agent coordination, and integration with multiple LLM providers through a unified config interface. The core building block is the Agent class, which talks to a model provider, can invoke tools, and returns structured replies; conversations are stateful, so calling ask() on a reply continues the same conversation thread.

The framework is designed for developers building autonomous or human-in-the-loop workflows where agents need to collaborate, persist knowledge, and call external functions. It uses pydantic for configuration, supports Python 3.10 through 3.14, and is actively maintained. The package is permissively licensed (Apache-2.0) and has no known security vulnerabilities.

Use it for

• Build a code-review agent that analyzes code snippets and suggests improvements across multiple turns.
• Coordinate multiple specialized agents (e.g., researcher, writer, editor) over a typed channel network to collaboratively produce documents.
• Create an autonomous assistant that calls external APIs or Python functions to fetch data, process it, and report results.
• Implement a human-in-the-loop workflow where an agent pauses to request confirmation or missing information from a person.
• Develop a multi-turn conversational system where agent state and history persist across multiple user interactions.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

ag2 on PyPI

Before you install

Installation is straightforward with low friction; the package is actively maintained with a recent release and strong repository activity. Requires Python 3.10 or later and pulls in 9 runtime dependencies including pydantic, httpx, and tiktoken.

Requires Python 3.10 or later. You must set OPENAI_API_KEY or provide an API key explicitly to OpenAIConfig; other model providers require their respective environment variables or explicit configuration.

License in practice

Licensed under Apache-2.0 (permissive), so you can use, modify, and distribute AG2 freely in commercial and private projects without restriction.

Quickstart

pip install ag2[openai]

import asyncio
from ag2 import Agent
from ag2.config import OpenAIConfig

agent = Agent(
    "assistant",
    prompt="You are a helpful assistant.",
    config=OpenAIConfig(model="gpt-4o-mini"),
)

async def main():
    reply = await agent.ask("Your question here")
    print(reply.body)

asyncio.run(main())

Package facts

Evidence: ag2-1.0.1-py3-none-any.whl

Tags

More Software Development packages

See also autogen · pyautogen · agent-framework-core · langgraph · agno · agent-framework-claude · agent-framework · fasta2a · pydantic-deep · agentscope

Further reading