<a name="readme-top"></a>

<div align="center">

    

</div>

AutoGen

AutoGen is a framework for creating multi-agent AI applications that can act autonomously or work alongside humans.

> Important: if you are new to AutoGen, please checkout Microsoft Agent Framework.
> AutoGen will still be maintained and continue to receive bug fixes and critical security patches.
> Read our announcement.

Installation

AutoGen requires Python 3.10 or later.

# Install AgentChat and OpenAI client from Extensions
pip install -U "autogen-agentchat" "autogen-ext[openai]"

The current stable version can be found in the releases. If you are upgrading from AutoGen v0.2, please refer to the Migration Guide for detailed instructions on how to update your code and configurations.

# Install AutoGen Studio for no-code GUI
pip install -U "autogenstudio"

Quickstart

The following samples call OpenAI API, so you first need to create an account and export your key as export OPENAI_API_KEY="sk-...".

Hello World

Create an assistant agent using OpenAI's GPT-4o model. See other supported models.

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
async def main() -> None:
    model_client = OpenAIChatCompletionClient(model="gpt-4.1")
    agent = AssistantAgent("assistant", model_client=model_client)
    print(await agent.run(task="Say 'Hello World!'"))
    await model_client.close()
asyncio.run(main())

MCP Server

Create a web browsing assistant agent that uses the Playwright MCP server.

``python

First run npm install -g @playwright/mcp@latest` to install the MCP server.

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_agentchat.ui import Console
from autogen_ext.models.openai import OpenAIChatCompletionClient
from a

... [truncated — view full README on GitHub]