freshcrate
Skin:/

ag2

AG2 (formerly AutoGen): The Open-Source AgentOS.Join us at: https://discord.gg/sNGSwQME3x

Why this rank:Strong adoptionRecent releaseHealthy release cadence

Description

AG2 (formerly AutoGen): The Open-Source AgentOS.Join us at: https://discord.gg/sNGSwQME3x

README



Downloads ๐Ÿ“š Documentation | ๐Ÿ’ก Examples | ๐Ÿค Contributing | ๐Ÿ“ Cite paper | ๐Ÿ’ฌ Join Discord

AG2 was evolved from AutoGen. Fully open-sourced. We invite collaborators from all organizations to contribute.

Important

AG2 is on the path to v1.0. The current framework will be tidied up through deprecations over the next few minor versions and moved to maintenance mode. The beta framework (autogen.beta) will become the official version of AG2 at v1.0.

Read the full release roadmap โ†’

AG2: Open-Source AgentOS for AI Agents

AG2 (formerly AutoGen) is an open-source programming framework for building AI agents and facilitating cooperation among multiple agents to solve tasks. AG2 aims to streamline the development and research of agentic AI. It offers features such as agents capable of interacting with each other, facilitates the use of various large language models (LLMs) and tool use support, autonomous and human-in-the-loop workflows, and multi-agent conversation patterns.

The project is currently maintained by a dynamic group of volunteers from several organizations. Contact project administrators Chi Wang and Qingyun Wu via support@ag2.ai if you are interested in becoming a maintainer.

Table of contents

Getting started

For a step-by-step walk through of AG2 concepts and code, see Basic Concepts in our documentation.

Installation

AG2 requires Python version >= 3.10, < 3.14. AG2 is available via ag2 (or its alias autogen) on PyPI.

Windows/Linux:

pip install ag2[openai]

Mac:

pip install 'ag2[openai]'

Minimal dependencies are installed by default. You can install extra options based on the features you need.

Setup your API keys

To keep your LLM dependencies neat and avoid accidentally checking in code with your API key, we recommend storing your keys in a configuration file.

In our examples, we use a file named OAI_CONFIG_LIST to store API keys. You can choose any filename, but make sure to add it to .gitignore so it will not be committed to source control.

You can use the following content as a template:

[
  {
    "model": "gpt-5",
    "api_key": "<your OpenAI API key here>"
  }
]

Run your first agent

Create a script or a Jupyter Notebook and run your first agent.

from autogen import AssistantAgent, UserProxyAgent, LLMConfig

llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")

assistant = AssistantAgent("assistant", llm_config=llm_config)

user_proxy = UserProxyAgent("user_proxy", code_execution_config={"work_dir": "coding", "use_docker": False})

user_proxy.run(assistant, message="Summarize the main differences between Python lists and tuples.").process()

Example applications

We maintain a dedicated repository with a wide range of applications to help you get started with various use cases or check out our collection of jupyter notebooks as a starting point.

Introduction of different agent concepts

We have several agent concepts in AG2 to help you build your AI agents. We introduce the most common ones here.

  • Conversable Agent: Agents that are able to send messages, receive messages and generate replies using GenAI models, non-GenAI tools, or human inputs.
  • Human in the loop: Add human input to the conversation
  • Orchestrating multiple agents: Users can orchestrate multiple agents with built-in conversation patterns such as swarms, group chats, nested chats, sequential chats or customize the orchestration by registering custom reply methods.
  • Tools: Programs that can be registered, invoked and executed by agents
  • Advanced Concepts: AG2 supports more concepts such as structured outputs, rag, code execution, etc.

Conversable agent

The ConversableAgent is the fundamental building block of AG2, designed to enable seamless communication between AI entities. This core agent type handles message exchange and response generation, serving as the base class for all agents in the framework.

Let's begin with a simple example where two agents collaborate:

  • A coder agent that writes Python code.
  • A reviewer agent that critiques the code without rewriting it.
import logging
from autogen import ConversableAgent, LLMConfig

# Configure logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

# Load LLM configuration
llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")

# Define agents
coder = ConversableAgent(
    name="coder",
    system_message="You are a Python developer. Write short Python scripts.",
    llm_config=llm_config,
)

reviewer = ConversableAgent(
    name="reviewer",
    system_message="You are a code reviewer. Analyze provided code and suggest improvements. "
                   "Do not generate code, only suggest improvements.",
    llm_config=llm_config,
)

# Start a conversation
response = reviewer.run(
            recipient=coder,
            message="Write a Python function that computes Fibonacci numbers.",
            max_turns=10
        )

response.process()

logger.info("Final output:\n%s", response.summary)

Orchestrating Multiple Agents

AG2 enables sophisticated multi-agent collaboration through flexible orchestration patterns, allowing you to create dynamic systems where specialized agents work together to solve complex problems.

Hereโ€™s how to build a team of teacher, lesson planner, and reviewer agents working together to design a lesson plan:

import logging
from autogen import ConversableAgent, LLMConfig
from autogen.agentchat import run_group_chat
from autogen.agentchat.group.patterns import AutoPattern

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")

# Define lesson planner and reviewer
planner_message = "You are a classroom lesson planner. Given a topic, write a lesson plan for a fourth grade class."
reviewer_message = "You are a classroom lesson reviewer. Compare the plan to the curriculum and suggest up to 3 improvements."

lesson_planner = ConversableAgent(
    name="planner_agent",
    system_message=planner_message,
    description="Creates or revises lesson plans.",
    llm_config=llm_config,
)

lesson_reviewer = ConversableAgent(
    name="reviewer_agent",
    system_message=reviewer_message,
    description="Provides one round of feedback to lesson plans.",
    llm_config=llm_config,
)

teacher_message = "You are a classroom teacher. You decide topics and collaborate with planner and reviewer to finalize lesson plans. When satisfied, output DONE!"

teacher = ConversableAgent(
    name="teacher_agent",
    system_message=teacher_message,
    is_termination_msg=lambda x: "DONE!" in (x.get("content", "") or "").upper(),
    llm_config=llm_config,
)

auto_selection = AutoPattern(
    agents=[teacher, lesson_planner, lesson_reviewer],
    initial_agent=lesson_planner,
    group_manager_args={"name": "group_manager", "llm_config": llm_config},
)

response = run_group_chat(
    pattern=auto_selection,
    messages="Let's introduce our kids to the solar system.",
    max_rounds=20,
)

response.process()

logger.info("Final output:\n%s", response.summary)

Human in the Loop

Human oversight is often essential for validating or guiding AI outputs. AG2 provides the UserProxyAgent for seamless integration of human feedback.

Here we extend the teacherโ€“plannerโ€“reviewer example by introducing a human agent who validates the final lesson:

import logging
from autogen import ConversableAgent, LLMConfig, UserProxyAgent
from autogen.agentchat import run_group_chat
from autogen.agentchat.group.patterns import AutoPattern

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")

# Same agents as before, but now the human validator will pass to the planner who will check for "APPROVED" and terminate
planner_message = "You are a classroom lesson planner. Given a topic, write a lesson plan for a fourth grade class."
reviewer_message = "You are a classroom lesson reviewer. Compare the plan to the curriculum and suggest up to 3 improvements."
teacher_message = "You are an experienced classroom teacher. You don't prepare plans, you provide simple guidance to the planner to prepare a lesson plan on the key topic."

lesson_planner = ConversableAgent(
    name="planner_agent",
    system_message=planner_message,
    description="Creates or revises lesson plans before having them reviewed.",
    is_termination_msg=lambda x: "APPROVED" in (x.get("content", "") or "").upper(),
    human_input_mode="NEVER",
    llm_config=llm_config,
)

lesson_reviewer = ConversableAgent(
    name="reviewer_agent",
    system_message=reviewer_message,
    description="Provides one round of feedback to lesson plans back to the lesson planner before requiring the human validator.",
    llm_config=llm_config,
)

teacher = ConversableAgent(
    name="teacher_agent",
    system_message=teacher_message,
    description="Provides guidance on the topic and content, if required.",
    llm_config=llm_config,
)

human_validator = UserProxyAgent(
    name="human_validator",
    system_message="You are a human educator who provides final approval for lesson plans.",
    description="Evaluates the proposed lesson plan and either approves it or requests revisions, before returning to the planner.",
)

auto_selection = AutoPattern(
    agents=[teacher, lesson_planner, lesson_reviewer],
    initial_agent=teacher,
    user_agent=human_validator,
    group_manager_args={"name": "group_manager", "llm_config": llm_config},
)

response = run_group_chat(
    pattern=auto_selection,
    messages="Let's introduce our kids to the solar system.",
    max_rounds=20,
)

response.process()

logger.info("Final output:\n%s", response.summary)

Tools

Agents gain significant utility through tools, which extend their capabilities with external data, APIs, or functions.

import logging
from datetime import datetime
from typing import Annotated
from autogen import ConversableAgent, register_function, LLMConfig

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

llm_config = LLMConfig.from_json(path="OAI_CONFIG_LIST")

# Tool: returns weekday for a given date
def get_weekday(date_string: Annotated[str, "Format: YYYY-MM-DD"]) -> str:
    date = datetime.strptime(date_string, "%Y-%m-%d")
    return date.strftime("%A")

date_agent = ConversableAgent(
    name="date_agent",
    system_message="You find the day of the week for a given date.",
    llm_config=llm_config,
)

executor_agent = ConversableAgent(
    name="executor_agent",
    human_input_mode="NEVER",
    llm_config=llm_config,
)

# Register tool
register_function(
    get_weekday,
    caller=date_agent,
    executor=executor_agent,
    description="Get the day of the week for a given date",
)

# Use tool in chat
chat_result = executor_agent.initiate_chat(
    recipient=date_agent,
    message="I was born on 1995-03-25, what day was it?",
    max_turns=2,
)

logger.info("Final output:\n%s", chat_result.chat_history[-1]["content"])

Advanced agentic design patterns

AG2 supports more advanced concepts to help you build your AI agent workflows. You can find more information in the documentation.

Announcements

๐Ÿ”ฅ ๐ŸŽ‰ Nov 11, 2024: We are evolving AutoGen into AG2! A new organization AG2AI is created to host the development of AG2 and related projects with open governance. Check AG2's new look.

๐Ÿ“„ License: We adopt the Apache 2.0 license from v0.3. This enhances our commitment to open-source collaboration while providing additional protections for contributors and users alike.

๐ŸŽ‰ May 29, 2024: DeepLearning.ai launched a new short course AI Agentic Design Patterns with AutoGen, made in collaboration with Microsoft and Penn State University, and taught by AutoGen creators Chi Wang and Qingyun Wu.

๐ŸŽ‰ May 24, 2024: Foundation Capital published an article on Forbes: The Promise of Multi-Agent AI and a video AI in the Real World Episode 2: Exploring Multi-Agent AI and AutoGen with Chi Wang.

๐ŸŽ‰ Apr 17, 2024: Andrew Ng cited AutoGen in The Batch newsletter and What's next for AI agentic workflows at Sequoia Capital's AI Ascent (Mar 26).

More Announcements

Code style and linting

This project uses prek hooks to maintain code quality. Before contributing:

  1. Install prek:
pip install prek
prek install
  1. The hooks will run automatically on commit, or you can run them manually:
prek run --all-files

Related papers

Contributors Wall

Cite the project

@software{AG2_2024,
author = {Chi Wang and Qingyun Wu and the AG2 Community},
title = {AG2: Open-Source AgentOS for AI Agents},
year = {2024},
url = {https://github.com/ag2ai/ag2},
note = {Available at https://docs.ag2.ai/},
version = {latest}
}

License

This project is licensed under the Apache License, Version 2.0 (Apache-2.0).

This project is a spin-off of AutoGen and contains code under two licenses:

We have documented these changes for clarity and to ensure transparency with our user and contributor community. For more details, please see the NOTICE file.

Release History

VersionChangesUrgencyDate
v0.13.3## Highlights ### ๐Ÿ›ฃ๏ธ Continuing the Path to v1.0 v0.13.3 brings a major Beta milestone โ€” the **cross-process Network** โ€” plus a new **`background_agent_tool`**, a **Sandbox protocol**, and evaluation improvements. ๐Ÿ“ [Release Roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/) --- ## ๐Ÿ”ฌ Beta Framework (`autogen.beta`) ### ๐ŸŒ Cross-Process Network The Network introduced in v0.13.0 ran in-process. v0.13.3 extends it across process boundaries โ€” agents living High6/5/2026
v0.13.2## Highlights ### ๐Ÿ›ฃ๏ธ Continuing the Path to v1.0 v0.13.2 brings Agent Evaluations in Beta! Also, two new V2 LLM clients in Classic, and a security fix. ๐Ÿ“ [Release Roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/) --- ## ๐Ÿ”ฌ Beta Framework (`autogen.beta`) ### Agent Evaluations - ๐Ÿงช **Agent Evaluations** โ€“ New evaluation framework for grading agent outputs (`autogen.beta.eval`). ๐ŸŽฎ **Try it live in the [AG2 Playground](https://playground.ag2.ai/)** ๐Ÿ“” *High5/29/2026
v0.13.1## Highlights ### ๐Ÿ›ฃ๏ธ Continuing the Path to v1.0 v0.13.1 spans both the **Beta** and **Classic** frameworks. ๐Ÿ“ [Release Roadmap to v1.0](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/) --- ## ๐Ÿ”ฌ Beta Framework ### Dynamic Agents - ๐Ÿญ **Dynamic Tool Factory** โ€“ Agents can now create an agent dynamically through their tooling. ### AG-UI - ๐Ÿง  **Reasoning Messages** โ€“ AG-UI now supports reasoning messages in both directions. - ๐ŸŽจ **Multimodal User Content**High5/23/2026
v0.13.0## Highlights ### ๐Ÿ›ฃ๏ธ The Path to v1.0 โ€” A Major Step v0.13.0 is a **significant release** for our journey to V1.0. It introduces a brand-new **Multi-Agent Network** runtime and **LiveAgent** for full-duplex realtime voice. Plus, **A2A v1.0** and **MCP** now in Beta to complete the connectivity story. ๐Ÿ“ [Release Roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/) ### ๐ŸŒ Network โ€” Multi-Agent Runtime (NEW) Other frameworks treat an agent or a graph as the primitiHigh5/13/2026
v0.12.3## Highlights v0.12.3 brings **A2A v1.0 compatibility**, sandboxed code execution in Beta, and a refreshed search story. ๐Ÿ“ [Release Roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/) ยท ๐Ÿ“” [V1.0 Contribution Policy](https://docs.ag2.ai/latest/docs/beta/contribution_policy/) ### ๐Ÿค A2A v1.0 Compatibility - ๐Ÿ”— **A2A v1.0 Spec Compatibility** โ€“ AG2 now aligns with the v1.0 Agent2Agent protocol specification, ensuring interoperability with the broader A2A ecosystem. High5/6/2026
v0.12.2### ๐Ÿ›ฃ๏ธ Continuing the Path to v1.0 v0.12.2 lands the **Agent Harness** in Beta โ€” the architecture that makes agents stateful by design. ๐Ÿ“ [Release Roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/) ๐Ÿงฉ [AG2 Playground](https://playground.ag2.ai) ### ๐Ÿ—๏ธ The Agent Harness โ€” Stateful Agents, by Design A plain LLM loop is stateless and forgets the moment a conversation ends. The Harness turns it into a stateful agent that **remembers across sessions, manages its ownHigh5/1/2026
v0.12.1## Highlights ### BREAKING - **Docker Moved to Extra** - The `docker` package, used for code execution with Docker, is now an optional dependency. please install with `ag2[docker]`. ### ๐Ÿ›ฃ๏ธ Continuing the Path to v1.0 v0.12.1 builds on the v0.12.0 foundation with new tools, Google Vertex AI support, bug fixes, and **community feedback** on the [roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/). ### ๐Ÿ‘ฅ Community Feedback in Action - โœ… **`PerplexitySearchToolHigh4/24/2026
v0.12.0## Highlights ### ๐Ÿ›ฃ๏ธ AG2 v0.12.0 โ€“ The Path to v1.0 Begins This release kicks off **the journey to AG2 v1.0**. Over the next few minor versions (v0.12 โ†’ v0.13 โ†’ v0.14 โ†’ v1.0), the beta framework (`autogen.beta`) will mature and, at v1.0, become the official version of AG2. The current framework continues to be fully supported throughout this transition. ๐Ÿ“ **Check out the full [Release Roadmap](https://docs.ag2.ai/latest/docs/user-guide/release-roadmap/)** to see what's coming. ### High4/17/2026
v0.11.5## Highlights ### ๐ŸŽ‰ Major Features - ๐Ÿ–ฅ๏ธ **AG2 CLI** โ€“ New command-line interface for AG2! A full-featured CLI for building, running, testing, and deploying multi-agent applications with AG2. [Check out the docs](https://docs.ag2.ai/latest/docs/user-guide/cli/)! - ๐Ÿ–ฅ๏ธ **A2UIAgent** โ€“ New reference agent combining A2A and [A2UI](https://a2ui.org/) protocols for building dynamic, agent-driven, frontends. Compatible with [A2UI](https://a2ui.org/)'s latest v0.9 protocol version. [Check out tHigh4/4/2026
v0.11.4## Highlights ### ๐Ÿ”’ Security Hardening This release includes several important security fixes contributed by @amabito: - **Shell Command Injection** โ€“ `ShellExecutor` now uses `shell=False` with `shlex.split` to prevent command injection. - **Path Traversal Prevention** โ€“ MCP resource URIs and file operations now validate against path traversal attacks. - **Sensitive Key Redaction** โ€“ `FileLogger` output now redacts sensitive keys to prevent credential leakage. ### AG2 Beta ImprovLow3/17/2026
v0.11.3## Highlights ### ๐ŸŽ‰ AG2 Beta โ€” A New Foundation for Real-World Agents This release introduces **AG2 Beta** (`autogen.beta`), a ground-up redesign of the AG2 framework built around lessons learned from the original architecture. AG2 Beta provides a stronger foundation for production agentic systems with: - ๐ŸŒŠ **Streaming & Event-Driven Architecture** โ€“ Every conversation runs on a `MemoryStream`, a pub/sub event bus that isolates state, enables real-time streaming, and makes agents safeLow3/16/2026
v0.11.2## Highlights ### Enhancements - ๐Ÿ”ง **Extra Headers Support** โ€“ Added `extra_headers` support to `OpenAILLMConfigEntry` and `AzureOpenAILLMConfigEntry`, allowing custom HTTP headers for API requests. ### LLM Client Fixes - ๐Ÿ”ง **Gemini Parallel Tool Calls** โ€“ Fixed support for parallel tool calls in the Gemini client. - ๐Ÿ”ง **Gemini Structured Output** โ€“ Fixed Gemini structured output when using `additionalProperties`. - ๐Ÿ”ง **OpenAI Responses Client** โ€“ Fixed empty string content hanLow2/27/2026
v0.11.1## Highlights ### ๐ŸŽ‰ Major Features - ๐ŸŒŠ **A2A Streaming** โ€“ Full streaming support for Agent2Agent communication, both server and client-side. LLM text streaming is now connected through to the A2A implementation, enabling real-time responses for remote agents. [Get Started](https://docs.ag2.ai/latest/docs/user-guide/a2a/) - ๐Ÿ™‹ **A2A HITL Events** โ€“ Process human-in-the-loop events in Agent2Agent communication, enabling interactive approval workflows in your agent pipelines. [Get StartLow2/16/2026
v0.11.0## Highlights ### ๐ŸŽ‰ Major Features - ๐Ÿ–ฅ๏ธ **AG-UI Protocol Integration** โ€“ AG2 now natively supports the [AG-UI protocol](https://docs.ag-ui.com/), the open standard for agent-to-user interaction. Build dynamic, real-time frontends powered by your AG2 agents with streaming responses, shared state synchronization, tool call rendering, and human-in-the-loop workflows. Seamlessly connect to CopilotKit and other AG-UI compatible frontends. [Get Started](https://docs.ag2.ai/latest/docs/user-guiLow2/10/2026
v0.10.5## Highlights ### Enhancements - ๐Ÿš€ **GPT 5.2 Codex Models Support** โ€“ Added support for OpenAI's GPT 5.2 Codex models, bringing enhanced coding capabilities to your agents. - ๐Ÿš **GPT 5.1 Shell Tool Support** โ€“ The Responses API now supports the shell tool, enabling agents to interact with command-line interfaces for filesystem diagnostics, build/test flows, and complex agentic coding workflows. Check out the blogpost: [Shell Tool and Multi-Inbuilt Tool Execution](https://docs.ag2.ai/laLow1/30/2026
v0.10.4## Highlights - ๐Ÿ•น๏ธ **Step-through Execution** - A powerful new orchestration feature `run_iter` (and `run_group_chat_iter`) that allows developers to pause and step through agent workflows event-by-event. This enables granular debugging, human-in-the-loop validation, and precise control over the execution loop. - โ˜๏ธ **AWS Bedrock "Thinking" & Reliability** - significant upgrades to the Bedrock client: - **Reliability**: Added built-in support for **exponential backoff and retries**, resoLow1/15/2026
v0.10.3## Highlights ### Enhancements - ๐Ÿš€ **OpenAI GPT 5.2 Support** โ€“ Added support for OpenAI's latest GPT-5.2 models, including the new `xhigh` reasoning effort level for enhanced performance on complex tasks. - ๐Ÿ› ๏ธ **OpenAI GPT 5.1 `apply_patch` Tool Support** โ€“ The Responses API now supports the `apply_patch` tool, enabling structured code editing with V4A diff format for multi-file refactoring, bug fixes, and precise code modifications. Check out the tutorial notebook: [GPT 5.1 apply_patchLow12/19/2025
v0.10.2## Highlights - ๐Ÿง  Anthropic Structured Outputs - AG2 now supports Anthropicโ€™s new Structured Output API, enabling schema-guaranteed responses via constrained decoding. Check out the tutorial notebook to see how structured outputs work across multiple AG2 orchestration patterns: [Anthropic Structured Outputs with AG2](https://github.com/ag2ai/ag2/blob/main/notebook/agentchat_anthropic_structured_outputs.ipynb). - โš™๏ธ Added first-class support for Bedrock structured outputs using the response_fLow12/5/2025
v0.10.1## Highlights - ๐Ÿง  New OpenAI Client Architecture - the first of our V2 client architectures, providing a foundation for multi-modal messages and access to thinking/reasoning tokens. Fully compatible with agents using V1 clients. Check out our [Image input/output](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_openai_v2_client_image/) and [V1 and V2 client compatibility](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_v1_v2_client_compatibility/)Low11/14/2025
v0.10.0## Highlights in 0.10! ๐ŸŒ **Remote Agents with A2A Protocol** โ€“ AG2 now supports the open standard **Agent2Agent (A2A)** protocol, enabling your AG2 agents to discover, communicate, and collaborate with agents across different platforms, frameworks, and vendors. Build truly interoperable multi-agent systems that work seamlessly with agents from LangChain, CrewAI, and other frameworks. [Get started with Remote Agents!](https://docs.ag2.ai/latest/docs/user-guide/a2a/) ๐Ÿ›ก๏ธ **Safe Guards in GrLow10/22/2025
v0.9.10## Highlights ๐Ÿ›ก๏ธ Maris Security Framework - Introducing policy-guided safeguards for multi-agent systems with configurable communication flow guardrails, supporting both regex and LLM-based detection methods for comprehensive security controls across agent-to-agent and agent-to-environment interactions. [Get started](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/orchestration/group-chat/safeguards/) ๐Ÿ—๏ธ YepCode Secure Sandbox - New secure, serverless code execution platform iLow10/3/2025
v0.9.9## Highlights ๐Ÿชฒ Bug fixes - including package version comparison fix ๐Ÿ“” Documentation updates ## What's Changed * Package build updates by @marklysze in https://github.com/ag2ai/ag2/pull/2033 * Fix Markdown Formatting in Verbosity Example Notebook by @BlocUnited in https://github.com/ag2ai/ag2/pull/2038 * Fix markdown formatting in GPT-5 verbosity example notebook by @BlocUnited in https://github.com/ag2ai/ag2/pull/2039 * Fix: Correct package dependency version comparisons by @marklyszLow8/20/2025
v0.9.8.post1## Highlights from v0.9.8 ๐Ÿง  Full GPT-5 Support โ€“ All GPT-5 variants are now supported, including gpt-5, mini, and nano. [Try it here](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_gpt-5_verbosity_example/) ๐Ÿ Python 3.9 Deprecation โ€“ With Python 3.9 nearing end-of-support, AG2 now requires Python 3.10+. ๐Ÿ› ๏ธ MCP Attribute Bug Fixed โ€“ No more hiccups with MCP attribute handling. ๐Ÿ”’ Security & Stability โ€“ Additional security patches and bug fixes to keep things smoothLow8/15/2025
v0.9.8## Highlights ๐Ÿง  Full GPT-5 Support โ€“ All GPT-5 variants are now supported, including gpt-5, mini, and nano. [Try it here](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_gpt-5_verbosity_example/) ๐Ÿ Python 3.9 Deprecation โ€“ With Python 3.9 nearing end-of-support, AG2 now requires Python 3.10+. ๐Ÿ› ๏ธ MCP Attribute Bug Fixed โ€“ No more hiccups with MCP attribute handling. ๐Ÿ”’ Security & Stability โ€“ Additional security patches and bug fixes to keep things smooth and safe. Low8/15/2025
v0.9.7## Highlights * ๐Ÿ”Ž AG2 welcomes xAI's Grok and its live search! [Try it out](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_grok_example/) * โš™๏ธ [Static and dynamic tool registration](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agent_tools_run_examples/) for two-agent chats * ๐Ÿง  Support for the `seed` parameter on `LLMConfig` with Gemini models * ๐Ÿ› ๏ธ Security and bug fixes ## What's Changed * Improve documentation and test coverage for filter_conLow7/25/2025
v0.9.6## What's Changed * Release image update by @marklysze in https://github.com/ag2ai/ag2/pull/1931 * change para name to avoid collision by @qingyun-wu in https://github.com/ag2ai/ag2/pull/1937 * feat: Add configurable routing method to LLMConfig and OpenAIWrapper by @sonichi in https://github.com/ag2ai/ag2/pull/1936 * Support container_create_kwargs in DockerCommandLineCodeExecutor by @salma-remyx in https://github.com/ag2ai/ag2/pull/1929 * Python code execution tool (System/Venv/Docker) by Low7/8/2025
v0.9.5## Highlights ๐Ÿ–ผ๏ธ **Image generation and understanding** Use our OpenAI Responses API integration to generate images and for image understanding. - [Getting started](https://docs.ag2.ai/latest/docs/user-guide/models/openai_responses/) - [Image Generation notebook](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_oai_responses_image/) - [Tool use](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/agentchat_oai_responses_api_tool_call/) and [StructuredLow7/4/2025
v0.9.4## ๐ŸŒŸ Highlights ๐Ÿ›ก๏ธ **Guardrails for AG2 GroupChat Are Here!!!** Take control of your multi-agent workflows with Guardrails โ€“ a powerful new feature that lets you enforce execution constraints, validate outputs, and keep your agentic orchestration safe and reliable. ๐Ÿ” Dive into the docs: [docs.ag2.ai โžœ Guardrails](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/orchestration/group-chat/guardrails/) ๐ŸŒŠ **Streamable-HTTP for Lightning-Fast MCP** โšก Streamable-HTTP is now suppoLow6/28/2025
v0.9.3## Highlights - ๐Ÿ‘ฅ Group Chat: Multiple After Works can now be added, utilising context-based conditions and availability ([Docs](https://docs.ag2.ai/latest/docs/api-reference/autogen/agentchat/group/handoffs/Handoffs/#autogen.agentchat.group.handoffs.Handoffs.add_after_works)) - ๐Ÿ“ Check out the new [blog post on advanced ReAct loops](https://docs.ag2.ai/latest/docs/blog/2025/06/12/ReAct-Loops-in-GroupChat/) from Nipun Suwandaratna - ๐Ÿ“” DocAgent updates for improved follow-up question answerLow6/17/2025
v0.9.2## Highlights - ๐Ÿ”’ **ReliableTool** - Ensure your tools do what you need them to do! - [Documentation](https://docs.ag2.ai/0.9.2/docs/api-reference/autogen/tools/experimental/ReliableTool/) - Notebook examples: [Basic](https://github.com/ag2ai/ag2/blob/main/notebook/reliable_basic_example.ipynb), [Group Chat](https://github.com/ag2ai/ag2/blob/main/notebook/reliable_group_chat.ipynb), [Google Search](https://github.com/ag2ai/ag2/blob/main/notebook/reliable_google_search.ipynb) - โš™๏ธ ๐Ÿ“– MCPLow6/4/2025
v0.9.1## Highlights - ๐ŸŒ DuckDuckGo Search Tool! - Check out the [Notebook](https://github.com/ag2ai/ag2/blob/main/notebook/tools_duckduckgo_search.ipynb) - ๐Ÿง  OpenAI / Azure OpenAI LLM configurations now support `reasoning_effort` and `max_completion_tokens` - ๐Ÿ‘ฅ `run_group_chat` and `a_run_group_chat` now available for iterating through the new Group Chat with events - ๐Ÿ“– Documentation and notebook corrections and updates :alarm_clock: Reminder: Ensure you're using the `ag2` package so yoLow5/6/2025
v0.9.0## Highlights for **0.9** ### New Group Chat! ๐Ÿ‘ฅ - We've brought together our group chat and swarm functionality to make a new Group Chat - designed to be extensible, controllable, and scalable. - ๐Ÿš€ **Get Started Now** - [Introduction and walk-through of the new Group Chat](https://docs.ag2.ai/latest/docs/user-guide/advanced-concepts/orchestration/group-chat/introduction/) - ๐Ÿงฉ **Pre-built patterns** - get up and running quickly by choosing out-of-the-box patterns such as `AutoPattern`, `Low4/25/2025
v0.8.7## Highlights - ๐ŸŒ WikipediaAgent! Pre-built agent with tools loaded, ready out-of-the-box for searching Wikipedia. - [Documentation](https://docs.ag2.ai/latest/docs/user-guide/reference-agents/wikipediaagent/) - ๐Ÿง  TavilySearchTool! Realtime web searches using Tavily, expand your online search capabilities. - [Notebook](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/tools_tavily_search/) - ๐Ÿš€ Anthropic integration updated to support Extended Thinking! - [DocumentationLow4/17/2025
v0.8.6## Highlights - ๐Ÿ“– Mega documentation update - thanks to all the contributors that helped! - New documentation look and engine, including versioning, [check it out](https://docs.ag2.ai/latest/)! โœจ - We'd love your feedback ([Discord](https://discord.gg/pAbnFJrkgZ), or create an [Issue](https://github.com/ag2ai/ag2/issues)) ๐Ÿซถ - ๐Ÿ” ReasoningAgent introduces `scope` to enhance the thinking process - ๐Ÿ› ๏ธ General fixes โ™ฅ๏ธ Thanks to all the contributors and collaborators that helped make Low4/10/2025
v0.8.5## Highlights - ๐Ÿงฉ MCP! A Model Client Protocol client is now available, create a toolkit of MCP tools for your AG2 agents! - [Notebook](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/mcp_client/) - โญ๏ธ `run` and `run_swarm` now allow you to iterate through the AG2 events! More control and easily integrate with your frontend. - [Notebook](https://docs.ag2.ai/latest/docs/use-cases/notebooks/notebooks/run_and_event_processing/) - ๐ŸŒ Wikipedia tools, `WikipediaQueryRunTool` aLow4/3/2025
v0.8.4## Highlights - ๐Ÿ”ฎ Perplexity AI Search Tool! Add AI-based web search capabilities to your agents. - [Documentation](https://docs.ag2.ai/docs/user-guide/reference-tools/perplexity-search), [Notebook](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/tools_perplexity_search) - ๐Ÿ”ด YouTube Search Tool! Enable your agents to find videos on YouTube using natural language. - [Documentation](https://docs.ag2.ai/docs/user-guide/reference-tools/google-api/youtube-search), [Notebook](https://Low3/28/2025
v0.8.3## Highlights - *FIXED*: LLMConfig bug that associated an agent's tools with other agents using the same LLM Configuration when using the context manager - ๐ŸŒ BrowserUseTool can now return the URLs used - ๐Ÿš€ Anthropic client class now supported by MultimodalConversableAgent for images (great for OCR) - ๐Ÿ” ReasoningAgent improved alignment through prompting and code execution config fix - ๐Ÿ› ๏ธ๐Ÿ“– Fixes and documentation improvements โ™ฅ๏ธ Thanks to all the contributors and collaborators that hLow3/20/2025
v0.8.2## Highlights - ๐Ÿ” Add **real-time web searches** to your agents using the new [Google Search Tool](https://docs.ag2.ai/docs/user-guide/reference-tools/google-api/google-search)! - ๐Ÿ“ LLM configurations can now use a new type-safe [LLMConfig](https://docs.ag2.ai/docs/user-guide/basic-concepts/llm-configuration/llm-configuration) object - ๐Ÿ“”โšก [`DocAgent`](https://docs.ag2.ai/docs/user-guide/reference-agents/docagent) can now add citations! [See howโ€ฆ](https://docs.ag2.ai/docs/use-cases/notebookLow3/17/2025
v0.8.2rc0## Highlights * ๐Ÿค– Updated support for OpenAI package 1.66.2 * โ›“๏ธโ€๐Ÿ’ฅ Removed dependencies: pysqlite3-binary and fast-depends * ๐Ÿ” Added GoogleSearchTool * ๐Ÿ“– Many improvements to documentation and the API reference * ๐Ÿ› ๏ธ Fixes, fixes and more fixes ## What's Changed * Updated support for OpenAI package 1.66.2 by @marklysze in https://github.com/ag2ai/ag2/pull/1320 * [Docs] Add blogs to mkdocs by @harishmohanraj in https://github.com/ag2ai/ag2/pull/1312 * Remove pysqlite3-binary depeLow3/13/2025
v0.8.1## Highlights - ๐Ÿง  Google GenAI's latest package is now supported - ๐Ÿ“” [`DocAgent`](https://docs.ag2.ai/docs/user-guide/reference-agents/docagent) now utilises [OnContextCondition](https://docs.ag2.ai/docs/user-guide/advanced-concepts/swarm/deep-dive#registering-context-variable-based-handoffs-to-agents) for a faster and even more reliable workflow - ๐Ÿ Swarm function registration fixes and [notebook](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/agentchat_swarm_enhanced) improvementLow3/10/2025
v0.8.0## Highlights for **0.8** ### :grey_exclamation: Breaking Change The `openai` package is no longer installed by default. - Install AG2 with the appropriate extra to use your preferred LLMs, e.g. `pip install ag2[openai]` for OpenAI or `pip install ag2[gemini]` for Google's Gemini. - See our [Model Providers](https://docs.ag2.ai/docs/user-guide/models/openai) documentation for details on installing AG2 with different model providers. ### 0.7.6 to 0.8 Highlights - ๐Ÿ“” [`DocAgent`](Low3/5/2025
v0.8.0b1## :grey_exclamation: Breaking Change The `openai` package is no longer installed by default. - Install AG2 with the appropriate extra to use your preferred LLMs, e.g. `pip install ag2[openai]` for OpenAI or `pip install ag2[gemini]` for Google's Gemini. - See our [Model Providers](https://docs.ag2.ai/docs/user-guide/models/openai) documentation for details on installing AG2 with different model providers. ## New Contributors * @SITADRITA1 made their first contribution in https://giLow2/28/2025
v0.7.6**Note:** OpenAI's `openai` package is no longer installed by default. See release notes for [v0.8.0b1](https://github.com/ag2ai/ag2/releases/tag/v0.8.0b1) for further information. ## Highlights - ๐Ÿš€ LLM provider streamlining and updates: - OpenAI package now optional (`pip install ag2[openai]`) - Cohere updated to support their Chat V2 API - Gemini support for system_instruction parameter and async - Mistral AI fixes for use with LM Studio - Anthropic improved support for tooLow2/27/2025
v0.7.6b1## Highlights - ๐Ÿš€ LLM provider streamlining and updates: - OpenAI package now optional (`pip install ag2[openai]`) - Cohere updated to support their Chat V2 API - Gemini support for system_instruction parameter and async - Mistral AI fixes for use with LM Studio - Anthropic improved support for tool calling - ๐Ÿ“” [`DocAgent`](https://docs.ag2.ai/docs/user-guide/reference-agents/docagent) - DocumentAgent is now **DocAgent** and has reliability refinements (with more to come) - Low2/27/2025
v0.7.5## Highlights - ๐Ÿ“” [**`DocumentAgent`**](https://docs.ag2.ai/docs/user-guide/reference-agents/documentagent) - A RAG solution built into an agent! - Ingest one or many PDFs, images with OCR, web pages, and more... - Query your documents with natural language - [Introduction to DocumentAgent](https://docs.ag2.ai/docs/user-guide/reference-agents/documentagent) - [Notebook](https://docs.ag2.ai/notebooks/agents_document_agent) - ๐ŸŽฏ Added support for Couchbase Vector database Low2/20/2025
0.7.4## Highlights * ๐Ÿ” New [**`DeepResearchAgent`**](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/agents_deep_researcher) was added * ๐Ÿ’ฌ New Messaging Platform Tools & Agents were added for the following platforms: * [**Blog**](https://docs.ag2.ai/docs/blog/2025-02-05-Communication-Agents/index) * [**Notebook**](https://docs.ag2.ai/docs/use-cases/notebooks/notebooks/tools_commsplatforms) * [**`DiscordAgent`**](https://docs.ag2.ai/docs/api-reference/autogen/agents/experimental/Low2/12/2025
v0.7.3## Highlights - ๐ŸŒ WebSurfer Agent - Search the web with an agent, powered by a browser or a crawler! ([Notebook](https://docs.ag2.ai/notebooks/agents_websurfer)) - ๐Ÿ’ฌ New agent `run` - Get up and running faster by having a chat directly with an AG2 agent using their new `run` method ([Notebook](https://docs.ag2.ai/notebooks/agentchat_assistant_agent_standalone)) - ๐Ÿš€ Google's new SDK - AG2 is now using Google's new Gen AI SDK! - ๐Ÿ› ๏ธ Fixes, more fixes, and documentation WebSurfer Agent seLow1/30/2025
v0.7.2## Highlights - ๐Ÿš€๐Ÿ”‰ Google Gemini-powered RealtimeAgent - ๐Ÿ—œ๏ธ๐Ÿ“ฆ Significantly lighter default installation package, fixes, test improvements Thanks to all the contributors on 0.7.2! * @leopardracer made their first contribution in https://github.com/ag2ai/ag2/pull/512 * @zeevick10 made their first contribution in https://github.com/ag2ai/ag2/pull/513 * @kilavvy made their first contribution in https://github.com/ag2ai/ag2/pull/515 * @vtjl10 made their first contribution in https://giLow1/22/2025
v0.7.2b1## Highlights - ๐Ÿš€๐Ÿ”‰ Google Gemini-powered RealtimeAgent - ๐Ÿ—œ๏ธ๐Ÿ“ฆ Significantly lighter default installation package, fixes, test improvements Thanks to all the contributors on 0.7.2! ## New Contributors * @leopardracer made their first contribution in https://github.com/ag2ai/ag2/pull/512 * @zeevick10 made their first contribution in https://github.com/ag2ai/ag2/pull/513 * @kilavvy made their first contribution in https://github.com/ag2ai/ag2/pull/515 * @vtjl10 made their first contrLow1/22/2025
v0.7.1## Highlights - ๐Ÿ•ธ๏ธ ๐Ÿง  GraphRAG integration of Neo4j's native GraphRAG SDK ([Notebook](https://docs.ag2.ai/notebooks/agentchat_graph_rag_neo4j_native)) - ๐Ÿค–๐Ÿง  OpenAI o1 support (o1, o1-preview, o1-mini) - ๐Ÿ”„ ๐Ÿ“ Structured outputs extended to Anthropic, Gemini, and Ollama - Fixes, documentation, and blog posts ## New Contributors * @giorgossideris made their first contribution in https://github.com/ag2ai/ag2/pull/489 ## What's Changed * Add linting rules to ruff check and format code Low1/15/2025
v0.7.0## Highlights from this Major Release ๐Ÿš€๐Ÿ”ง Introducing **Tools with Dependency Injection**: Secure, flexible, tool parameters using dependency injection - [Blog](https://docs.ag2.ai/blog/2025-01-07-Tools-Dependency-Injection/index) - [Notebook Example](https://docs.ag2.ai/notebooks/tools_dependency_injection) - [Video](https://www.youtube.com/watch?v=OQX1Qk4VpM0) ๐Ÿš€๐Ÿ”‰ Introducing **RealtimeAgent with WebRTC**: Add Realtime agentic voice to your applications with WebRTC - [Demo Repo](Low1/8/2025
v0.7.0b3## Highlights from this Major Release ๐Ÿš€๐Ÿ”ง Introducing **Tools with Dependency Injection**: Secure, flexible, tool parameters using dependency injection - [Notebook Example](https://docs.ag2.ai/notebooks/tools_dependency_injection) - Video (Coming soon) ๐Ÿš€๐Ÿ”‰ Introducing **RealtimeAgent with WebRTC**: Add Realtime agentic voice to your applications with WebRTC - Blog (Coming soon) - Notebook (Coming soon) - Video (Coming soon) ๐Ÿš€๐Ÿ’ฌIntroducing **Structured Messages**: Direct and fiLow1/8/2025
v0.7.0b1## Highlights from this Major Release ๐Ÿš€๐Ÿ”ง Introducing **Tools with Dependency Injection**: Secure, flexible, tool parameters using dependency injection - [Notebook Example](https://docs.ag2.ai/notebooks/tools_dependency_injection) - Video TBD ๐Ÿš€๐Ÿ”‰ Introducing **RealtimeAgent with WebRTC**: Add Realtime agentic voice to your applications with WebRTC - Blog (Coming soon) - Notebook (Coming soon) - Video (Coming soon) ๐Ÿš€๐Ÿ’ฌIntroducing **Structured Messages**: Direct and filter AG2'sLow1/8/2025
v0.6.1## Highlights ๐Ÿš€๐Ÿ”ง CaptainAgent's team of agents can now use 3rd party tools! - [Notebook](https://docs.ag2.ai/notebooks/agentchat_captainagent_crosstool) - If you're new to CaptainAgent, check out our [video](https://www.youtube.com/watch?v=laGZmQUolBY) and [blog post](https://docs.ag2.ai/blog/2024-11-15-CaptainAgent/index#introducing-captainagent-for-adaptive-team-building) ๐Ÿš€๐Ÿ”‰ RealtimeAgent fully supports OpenAI's latest Realtime API and refactored to support real-time APIs from otLow12/30/2024
v0.6.0## Highlights from this Major Release ๐Ÿš€๐Ÿ”‰ Introducing **RealtimeAgent**: Realtime voice in AG2! Speak with your agents! - [Blogpost](https://docs.ag2.ai/blog/2024-12-20-RealtimeAgent) - [Notebook Example](https://docs.ag2.ai/notebooks/agentchat_realtime_swarm) - [Video](https://youtu.be/NbZW2goinKM?si=3ZAnBpI0zO0ciEMl) ๐Ÿš€๐Ÿ” Introducing **ReasoningAgent with MCTS**: Monte Carlo Tree Search powered ReasoningAgent - [Blogpost](https://docs.ag2.ai/blog/2024-12-20-Reasoning-Update) - [NLow12/20/2024
v0.6.0b2## Highlights from this Major Release ๐Ÿš€๐Ÿ”‰ Introducing **RealtimeAgent**: Realtime voice in AG2! Speak with your agents! - [Blogpost](https://docs.ag2.ai/blog/2024-12-20-RealtimeAgent) - [Notebook Example](https://docs.ag2.ai/notebooks/agentchat_realtime_swarm) - [Video](https://youtu.be/NbZW2goinKM?si=3ZAnBpI0zO0ciEMl) ๐Ÿš€๐Ÿ” Introducing **ReasoningAgent with MCTS**: Monte Carlo Tree Search powered ReasoningAgent - [Blogpost](https://docs.ag2.ai/blog/2024-12-20-Reasoning-Update) - [NLow12/20/2024
v0.6.0b1## Highlights from this Major Release ๐Ÿš€๐Ÿ”‰ Introducing **RealtimeAgent**: Realtime voice in AG2! Speak with your agents! - [Blogpost](https://docs.ag2.ai/blog/2024-12-20-RealtimeAgent) - [Notebook Example](https://docs.ag2.ai/notebooks/agentchat_realtime_swarm) - [Video](https://youtu.be/NbZW2goinKM?si=3ZAnBpI0zO0ciEMl) ๐Ÿš€๐Ÿ” Introducing **ReasoningAgent with MCTS**: Monte Carlo Tree Search powered ReasoningAgent - [Blogpost](https://docs.ag2.ai/blog/2024-12-20-Reasoning-Update) - [NLow12/20/2024

Dependencies & License Audit

Loading dependencies...

Similar Packages

agentic-ai๐Ÿค– Explore AI agent architectures with agentic-ai, featuring ReAct agents, reflection-based designs, and modular LLM integrations using LangChain and LangGraph.main@2026-06-05
samplesAgent samples built using the Strands Agents SDK.main@2026-06-04
solace-agent-meshAn event-driven framework designed to build and orchestrate multi-agent AI systems. It enables seamless integration of AI agents with real-world data sources and systems, facilitating complex, multi-s1.28.0
sdk-pythonA model-driven approach to building AI agents in just a few lines of code.python/v1.42.0
SimpleLLMFuncA simple and well-tailored LLM application framework that enables you to seamlessly integrate LLM capabilities in the most "Code-Centric" manner. LLM As Function, Prompt As Code. ไธ€ไธช็ฎ€ๅ•็š„ๆฐๅˆฐv0.8.4

More in MCP Servers

AstrBotAgentic IM Chatbot infrastructure that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. โœจ
agentscopeBuild and run agents you can see, understand and trust.
claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.
langchain4jLangChain4j is an open-source Java library that simplifies the integration of LLMs into Java applications through a unified API, providing access to popular LLMs and vector databases. It makes impleme