AG2 (formerly AutoGen)

AG2 is the community fork of AutoGen. Same multi-agent DNA, plus a new event-driven architecture (autogen.beta), A2A protocol support, and a first-class CLI.

Install

pip install ag2

Version

v0.12.2 · May 2026 · Python 3.10+

Best for

Research-grade multi-agent systems, GroupChat, event-driven conversations.

Zero → Hero

1 · Overview & key features What AG2 is, what changed from AutoGen · 10 min

2 · Installation Install, LLM config · 10 min

3 · Basic usage ConversableAgent, GroupChat · 20 min

4 · Advanced concepts Tool use, human proxy, caching · 20 min

5 · Migration from legacy AutoGen Renames, breaking changes · 15 min

6 · autogen.beta (event-driven) New event-driven API · 20 min

7 · A2A protocol Cross-framework agent interop · 15 min

8 · AG2 CLI Project scaffolding, run, deploy · 10 min

9 · QuickResearchTool Built-in research workflow · 10 min

10 · Production Deployment, monitoring · 25 min

Jump to a topic

GroupChat

Event-driven (beta)

A2A protocol

AG2 CLI

QuickResearchTool

Migration from AutoGen

Reference

Comprehensive guide Single-page technical reference.

Recipes

Diagrams

Production guide

What’s new in v0.11.5 (April 2026)

autogen.beta — new event-driven architecture for complex conversations.
A2A protocol — interop with OpenAI SDK, Claude SDK, LangGraph, Google ADK.
AG2 CLI — project scaffolding, run, deploy.
QuickResearchTool — built-in research workflow helper.

Install, minimal example

from autogen import ConversableAgent, LLMConfig

# Option A — inline config
llm_config = LLMConfig({"api_type": "openai", "model": "gpt-4o"})

# Option B — load from OAI_CONFIG_LIST env var or file
# llm_config = LLMConfig.from_json(env="OAI_CONFIG_LIST")
# llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST.json")

agent = ConversableAgent(
    name="assistant",
    llm_config=llm_config,
    system_message="You are a helpful assistant.",
)

reply = agent.generate_reply(
    messages=[{"role": "user", "content": "Hello!"}]
)
print(reply)

config_list_from_json is not re-exported at the top of autogen in v0.11+. Use LLMConfig / LLMConfig.from_json (preferred) or the deep path from autogen.llm_config.config import config_list_from_json.

Ready? Start Zero → Hero Step 1 →

Revision history

Date	Version	Changes	Reviewer
2026-05-01	0.12.2	Version bumped 0.12.1 → 0.12.2; comprehensive guide header updated; revision history entry added. `autogen.ConversableAgent` import verified against installed 0.12.2 (`.routine-envs/check-ag2-0501`).	Claude routine
2026-04-25	0.12.1	Version bumped 0.12.0 → 0.12.1; comprehensive guide header updated; revision history entry added. Snippets verified against installed 0.12.1.	Claude routine
2026-04-21	0.11.5	Index redesigned with Zero → Hero + Jump-to-topic grid.	—
April 5, 2026	0.11.5	event-driven architecture; A2A; CLI; QuickResearchTool.	—
November 2025	0.3.2	Initial AG2 rebrand after AutoGen → AG2 community continuation.	—