autogen/python/packages/autogen-core/docs/src/index.md

myst	html_theme.sidebar_secondary.remove	sd_hide_title
html_meta description lang=en Top-level documentation for AutoGen, a framework for developing applications using AI agents	false	true

AutoGen

AutoGen

A framework for building AI agents and applications

::::{grid} :gutter: 2

:::{grid-item-card} :shadow: none :margin: 2 0 0 0 :columns: 12 12 6 6

{fas}book;pst-color-primary Magentic-One CLI

A console-based multi-agent assistant for web and file-based tasks. Built on AgentChat.

pip install -U magentic-one-cli
m1 "Find flights from Seattle to Paris and format the result in a table"

+++

:color: secondary

Get Started

:::

:::{grid-item-card} {fas}palette;pst-color-primary Studio :shadow: none :margin: 2 0 0 0 :columns: 12 12 6 6

An app for prototyping and managing agents without writing code. Built on AgentChat.

pip install -U autogenstudio
autogenstudio ui --port 8080 --appdir ./myapp

+++

:color: secondary

Get Started

:::

:::{grid-item-card} :shadow: none :margin: 2 0 0 0 :columns: 12 12 12 12

{fas}people-group;pst-color-primary AgentChat

A programming framework for building conversational single and multi-agent applications. Built on Core. Requires Python 3.10+.

# pip install -U "autogen-agentchat" "autogen-ext[openai]"
import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

async def main() -> None:
    agent = AssistantAgent("assistant", OpenAIChatCompletionClient(model="gpt-4o"))
    print(await agent.run(task="Say 'Hello World!'"))

asyncio.run(main())

Start here if you are building conversational agents. Migrating from AutoGen 0.2?.

+++

:color: secondary

Get Started

:::

:::{grid-item-card} {fas}cube;pst-color-primary Core :shadow: none :margin: 2 0 0 0 :columns: 12 12 12 12

An event-driven programming framework for building scalable multi-agent AI systems. Example scenarios:

• Deterministic and dynamic agentic workflows for business processes.
• Research on multi-agent collaboration.
• Distributed agents for multi-language applications.

Start here if you are building workflows or distributed agent systems.

+++

:color: secondary

Get Started

:::

:::{grid-item-card} {fas}puzzle-piece;pst-color-primary Extensions :shadow: none :margin: 2 0 0 0 :columns: 12 12 12 12

Implementations of Core and AgentChat components that interface with external services or other libraries. You can find and use community extensions or create your own. Examples of built-in extensions:

• {py:class}~autogen_ext.tools.langchain.LangChainToolAdapter for using LangChain tools.
• {py:class}~autogen_ext.agents.openai.OpenAIAssistantAgent for using Assistant API.
• {py:class}~autogen_ext.code_executors.docker.DockerCommandLineCodeExecutor for running model-generated code in a Docker container.
• {py:class}~autogen_ext.runtimes.grpc.GrpcWorkerAgentRuntime for distributed agents.

+++

Discover Community Extensions Create New Extension

:::

::::

:maxdepth: 3
:hidden:

user-guide/agentchat-user-guide/index
user-guide/core-user-guide/index
user-guide/extensions-user-guide/index
Studio <user-guide/autogenstudio-user-guide/index>
reference/index