Repository files navigation

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

AutoGen requiresPython 3.10 or later.

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

The current stable version is v0.4. If you are upgrading from AutoGen v0.2, please refer to theMigration Guide for detailed instructions on how to update your code and configurations.

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

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

importasynciofromautogen_agentchat.agentsimportAssistantAgentfromautogen_ext.models.openaiimportOpenAIChatCompletionClientasyncdefmain()->None:model_client=OpenAIChatCompletionClient(model="gpt-4o")agent=AssistantAgent("assistant",model_client=model_client)print(awaitagent.run(task="Say 'Hello World!'"))awaitmodel_client.close()asyncio.run(main())

Create a group chat team with a web surfer agent and a user proxy agentfor web browsing tasks. You need to installplaywright.

# pip install -U autogen-agentchat autogen-ext[openai,web-surfer]# playwright installimportasynciofromautogen_agentchat.agentsimportUserProxyAgentfromautogen_agentchat.conditionsimportTextMentionTerminationfromautogen_agentchat.teamsimportRoundRobinGroupChatfromautogen_agentchat.uiimportConsolefromautogen_ext.models.openaiimportOpenAIChatCompletionClientfromautogen_ext.agents.web_surferimportMultimodalWebSurferasyncdefmain()->None:model_client=OpenAIChatCompletionClient(model="gpt-4o")# The web surfer will open a Chromium browser window to perform web browsing tasks.web_surfer=MultimodalWebSurfer("web_surfer",model_client,headless=False,animate_actions=True)# The user proxy agent is used to get user input after each step of the web surfer.# NOTE: you can skip input by pressing Enter.user_proxy=UserProxyAgent("user_proxy")# The termination condition is set to end the conversation when the user types 'exit'.termination=TextMentionTermination("exit",sources=["user_proxy"])# Web surfer and user proxy take turns in a round-robin fashion.team=RoundRobinGroupChat([web_surfer,user_proxy],termination_condition=termination)try:# Start the team and wait for it to terminate.awaitConsole(team.run_stream(task="Find information about AutoGen and write a short summary."))finally:awaitweb_surfer.close()awaitmodel_client.close()asyncio.run(main())

Use AutoGen Studio to prototype and run multi-agent workflows without writing code.

# Run AutoGen Studio on http://localhost:8080autogenstudio ui --port 8080 --appdir ./my-app

The AutoGen ecosystem provides everything you need to create AI agents, especially multi-agent workflows -- framework, developer tools, and applications.

Theframework uses a layered and extensible design. Layers have clearly divided responsibilities and build on top of layers below. This design enables you to use the framework at different levels of abstraction, from high-level APIs to low-level components.

• Core API implements message passing, event-driven agents, and local and distributed runtime for flexibility and power. It also support cross-language support for .NET and Python.
• AgentChat API implements a simpler but opinionated API for rapid prototyping. This API is built on top of the Core API and is closest to what users of v0.2 are familiar with and supports common multi-agent patterns such as two-agent chat or group chats.
• Extensions API enables first- and third-party extensions continuously expanding framework capabilities. It support specific implementation of LLM clients (e.g., OpenAI, AzureOpenAI), and capabilities such as code execution.

The ecosystem also supports two essentialdeveloper tools:

• AutoGen Studio provides a no-code GUI for building multi-agent applications.
• AutoGen Bench provides a benchmarking suite for evaluating agent performance.

You can use the AutoGen framework and developer tools to create applications for your domain. For example,Magentic-One is a state-of-the-art multi-agent team built using AgentChat API and Extensions API that can handle a variety of tasks that require web browsing, code execution, and file handling.

With AutoGen you get to join and contribute to a thriving ecosystem. We host weekly office hours and talks with maintainers and community. We also have aDiscord server for real-time chat, GitHub Discussions for Q&A, and a blog for tutorials and updates.

Installation
Quickstart
Tutorial
API Reference
Packages

Interested in contributing? SeeCONTRIBUTING.md for guidelines on how to get started. We welcome contributions of all kinds, including bug fixes, new features, and documentation improvements. Join our community and help us make AutoGen better!

Have questions? Check out ourFrequently Asked Questions (FAQ) for answers to common queries. If you don't find what you're looking for, feel free to ask in ourGitHub Discussions or join ourDiscord server for real-time support. You can also read ourblog for updates.

Microsoft and any contributors grant you a license to the Microsoft documentation and other contentin this repository under theCreative Commons Attribution 4.0 International Public License,see theLICENSE file, and grant you a license to any code in the repository under theMIT License, see theLICENSE-CODE file.

Microsoft, Windows, Microsoft Azure, and/or other Microsoft products and services referenced in the documentationmay be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.Microsoft's general trademark guidelines can be found athttp://go.microsoft.com/fwlink/?LinkID=254653.

Privacy information can be found athttps://go.microsoft.com/fwlink/?LinkId=521839

Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents,or trademarks, whether by implication, estoppel, or otherwise.

↑ Back to Top ↑