📚 Documentation | 💡 Playground | 💡 Examples | 🤝 Contributing | 📝 Cite paper | 💬 Join Discord | 🏛️ AG2 Classic

[!IMPORTANT] Looking for ConversableAgent, GroupChat, or import autogen? That's now AG2 Classic.

As of AG2 v1.0, the protocol-driven framework is the top-level package, imported as ag2. The classic framework has moved to its own repository — ag2ai/ag2-classic, documented at classic.docs.ag2.ai. It is still maintained and installable; nothing you have built stops working.

This repository (pip install ag2) no longer ships the autogen import name or the classic agent classes.

AG2: Open-Source AgentOS for AI Agents

AG2 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

• AG2: Open-Source AgentOS for AI Agents
  • Table of contents
  • AG2 Classic (the autogen.* namespace)
  • Getting started
    • Installation
    • Setup your API keys
    • Run your first agent
  • Example applications
  • Introduction of different agent concepts
    • Agents
    • Tools
    • Human in the Loop
    • Orchestrating Multiple Agents
    • The agent harness: knowledge and compaction
    • Advanced agentic design patterns
  • Code style and linting
  • Contributors Wall
  • License

AG2 Classic (the autogen.* namespace)

AG2 Classic is the original AutoGen-derived framework: the autogen.* import namespace and its agent classes — ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat / GroupChatManager, swarms, register_function, LLMConfig / OAI_CONFIG_LIST, and the nested- and sequential-chat patterns.

It now lives in its own repository and has its own documentation site:

	AG2 Classic	AG2 (this repo)
Repository	ag2ai/ag2-classic	ag2ai/ag2
Documentation	classic.docs.ag2.ai	docs.ag2.ai
Import	import autogen	import ag2
Core agent	ConversableAgent	Agent
Multi-agent	GroupChat, swarms, nested chats	Network (hub + channels)

Are you using AG2 Classic?