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.13.3 · June 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.13.3 (June 2026)

v0.13.3 (June 2026) — Patch release; stability and dependency updates. All core symbols (ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat, GroupChatManager, register_function, runtime_logging) verified against installed ag2==0.13.3 (.routine-envs/refresh-py, 2026-06-07) with upstream jsonschema warning suppressed (known upstream issue); 57 top-level exports confirmed. No DeprecationWarning emissions from ag2 itself.
v0.13.2 (May 2026) — Patch release; stability and dependency updates. All core symbols (ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat, GroupChatManager, register_function, runtime_logging) verified against installed ag2==0.13.2 (.routine-envs/check-0529-ag2) with warnings suppressed (upstream jsonschema issue); 57 top-level exports confirmed.
v0.13.1 (May 2026) — Patch release; stability and dependency updates. All core symbols (ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat, GroupChatManager, register_function, runtime_logging) verified against installed ag2==0.13.1 (.routine-envs/check-0523-ag2) with -W error::DeprecationWarning (warnings suppressed for upstream issues); 57 top-level exports confirmed.
v0.13.0 (May 2026) — Minor release. Swarm API refactored: SwarmAgent and initiate_swarm_chat have been removed from the top-level autogen namespace. The canonical path is now from autogen.agentchat.contrib.swarm_agent import SwarmAgent, initiate_swarm_chat. Three new top-level swarm functions added: run_swarm(initial_agent, messages, agents, ...), a_run_swarm(...) (async), and a_initiate_swarm_chat(...) (async). All previously-verified core symbols (ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat, GroupChatManager, LLMConfig) confirmed present in installed ag2==0.13.0 (.routine-envs/check-0520-ag2).
v0.12.3 (May 9) — Patch release; stability and dependency updates. Note: autogen imports emit DeprecationWarning via jsonschema.RefResolver (upstream issue in jsonschema>=4.18.0; does not affect ag2 API behaviour).
v0.12.2 (May 1) — Patch release; stability improvements.

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-06-07	0.13.3	Patch release bump 0.13.2 → 0.13.3; version card updated to v0.13.3; “What’s new” heading updated; v0.13.3 bullet added; comprehensive guide description updated; revision history entry added. Core symbols (`ConversableAgent`, `AssistantAgent`, `UserProxyAgent`, `GroupChat`, `GroupChatManager`, `register_function`, `runtime_logging`) verified against installed `ag2==0.13.3` (`.routine-envs/refresh-py`, 2026-06-07) with upstream `jsonschema` warning suppressed; 57 top-level exports confirmed.	Claude routine
2026-05-29	0.13.2	Patch release bump 0.13.1 → 0.13.2; “What’s new” heading updated to v0.13.2; v0.13.2 bullet added; comprehensive guide header updated; revision history entry added. Core symbols (`ConversableAgent`, `AssistantAgent`, `UserProxyAgent`, `GroupChat`, `GroupChatManager`, `register_function`, `runtime_logging`) verified against installed `ag2==0.13.2` (`.routine-envs/check-0529-ag2`) with warnings suppressed (upstream issue); 57 top-level exports confirmed.	Claude routine
2026-05-23	0.13.1	Patch release bump 0.13.0 → 0.13.1; “What’s new” heading updated to v0.13.1; v0.13.1 bullet added; comprehensive guide header updated; revision history entry added. Core symbols (`ConversableAgent`, `AssistantAgent`, `UserProxyAgent`, `GroupChat`, `GroupChatManager`, `register_function`, `runtime_logging`) verified against installed `ag2==0.13.1` (`.routine-envs/check-0523-ag2`) with warnings suppressed (upstream issue); 57 top-level exports confirmed.	Claude routine
2026-05-20	0.13.0	Version bumped 0.12.3 → 0.13.0; “What’s new” heading updated to v0.13.0; v0.13.0 bullet added documenting swarm API refactor (`SwarmAgent`/`initiate_swarm_chat` moved to `autogen.agentchat.contrib.swarm_agent`; new top-level `run_swarm`, `a_run_swarm`, `a_initiate_swarm_chat`); comprehensive guide header updated; revision history entry added. Core symbols (`ConversableAgent`, `AssistantAgent`, `UserProxyAgent`, `GroupChat`, `GroupChatManager`, `LLMConfig`) verified against installed `ag2==0.13.0` (`.routine-envs/check-0520-ag2`) with `-W error::DeprecationWarning`; all PASS.	Claude routine
2026-05-09	0.12.3	Version bumped 0.12.2 → 0.12.3 (patch release); “What’s new” updated; comprehensive guide header updated; revision history entry added. `autogen.ConversableAgent`, `GroupChat`, `GroupChatManager`, `AssistantAgent`, `UserProxyAgent` verified against installed `ag2 0.12.3` (`.routine-envs/check-0509-py`). Upstream DeprecationWarning via `jsonschema.RefResolver` noted as ag2 upstream issue.	Claude routine
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.	—