Skip to content

A programming framework for agentic AI

Overhaul landing page, change top links (#611)

Jack Gerrits58ee8b7fc1d5
diff --git a/python/packages/autogen-core/docs/src/agentchat-user-guide/index.md b/python/packages/autogen-core/docs/src/agentchat-user-guide/index.md
new file mode 100644
index 000000000..c3bb1b5bb
--- /dev/null
+++ b/python/packages/autogen-core/docs/src/agentchat-user-guide/index.md
@@ -0,0 +1,12 @@
+---
+myst:
+ html_meta:
+ "description lang=en": |
+ User Guide for AutoGen AgentChat, a framework for building multi-agent applications with AI agents.
+---
+
+# AgentChat
+
+```{note}
+🚧 Under construction 🚧
+```
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/azure-openai-with-aad-auth.md b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/azure-openai-with-aad-auth.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/azure-openai-with-aad-auth.md
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/azure-openai-with-aad-auth.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/extracting-results-with-an-agent.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/extracting-results-with-an-agent.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/extracting-results-with-an-agent.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/extracting-results-with-an-agent.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/langgraph-agent.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/langgraph-agent.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/langgraph-agent.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/langgraph-agent.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/llamaindex-agent.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/llamaindex-agent.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/llamaindex-agent.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/llamaindex-agent.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/local-llms-ollama-litellm.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/local-llms-ollama-litellm.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/local-llms-ollama-litellm.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/local-llms-ollama-litellm.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/openai-assistant-agent.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/openai-assistant-agent.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/openai-assistant-agent.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/openai-assistant-agent.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/cookbook/termination-with-intervention.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/cookbook/termination-with-intervention.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/cookbook/termination-with-intervention.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/cookbook/termination-with-intervention.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/agent-and-multi-agent-application.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/agent-and-multi-agent-application.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/agent-and-multi-agent-application.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/agent-and-multi-agent-application.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/agent-identity-and-lifecycle.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/agent-identity-and-lifecycle.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/agent-identity-and-lifecycle.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/agent-identity-and-lifecycle.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/agent-lifecycle.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/agent-lifecycle.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/agent-lifecycle.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/agent-lifecycle.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/api-layers.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/api-layers.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/api-layers.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/api-layers.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/application-stack.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/application-stack.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/application-stack.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/application-stack.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/application-stack.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/application-stack.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/application-stack.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/application-stack.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/architecture-distributed.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/architecture-distributed.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/architecture-distributed.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/architecture-distributed.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/architecture-standalone.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/architecture-standalone.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/architecture-standalone.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/architecture-standalone.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/architecture.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/architecture.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/architecture.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/architecture.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/code-gen-example.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/code-gen-example.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/code-gen-example.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/code-gen-example.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/faqs.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/faqs.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/faqs.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/faqs.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/layers.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/layers.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/layers.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/layers.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/subscription.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/subscription.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/subscription.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/subscription.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/topic-and-subscription.md b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/topic-and-subscription.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/topic-and-subscription.md
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/topic-and-subscription.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/type-subscription-multi-tenant.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/type-subscription-multi-tenant.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/type-subscription-multi-tenant.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/type-subscription-multi-tenant.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/type-subscription-single-tenant-multiple-topics.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/type-subscription-single-tenant-multiple-topics.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/type-subscription-single-tenant-multiple-topics.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/type-subscription-single-tenant-multiple-topics.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/core-concepts/type-subscription-single-tenant-single-topic.svg b/python/packages/autogen-core/docs/src/core-user-guide/core-concepts/type-subscription-single-tenant-single-topic.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/core-concepts/type-subscription-single-tenant-single-topic.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/core-concepts/type-subscription-single-tenant-single-topic.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/agent-and-agent-runtime.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/agent-and-agent-runtime.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/agent-and-agent-runtime.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/agent-and-agent-runtime.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/coder-reviewer-data-flow.svg b/python/packages/autogen-core/docs/src/core-user-guide/guides/coder-reviewer-data-flow.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/coder-reviewer-data-flow.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/coder-reviewer-data-flow.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/command-line-code-executors.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/command-line-code-executors.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/command-line-code-executors.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/command-line-code-executors.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/distributed-agent-runtime.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/distributed-agent-runtime.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/distributed-agent-runtime.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/distributed-agent-runtime.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/group-chat.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/group-chat.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/group-chat.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/group-chat.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/installation.md b/python/packages/autogen-core/docs/src/core-user-guide/guides/installation.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/installation.md
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/installation.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/logging.md b/python/packages/autogen-core/docs/src/core-user-guide/guides/logging.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/logging.md
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/logging.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/message-and-communication.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/message-and-communication.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/message-and-communication.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/message-and-communication.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/model-clients.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/model-clients.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/model-clients.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/model-clients.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/multi-agent-design-patterns.md b/python/packages/autogen-core/docs/src/core-user-guide/guides/multi-agent-design-patterns.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/multi-agent-design-patterns.md
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/multi-agent-design-patterns.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/quickstart.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/quickstart.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/quickstart.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/quickstart.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/reflection.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/reflection.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/reflection.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/reflection.ipynb
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/telemetry.md b/python/packages/autogen-core/docs/src/core-user-guide/guides/telemetry.md
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/telemetry.md
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/telemetry.md
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/tool-use-agent-cfg.svg b/python/packages/autogen-core/docs/src/core-user-guide/guides/tool-use-agent-cfg.svg
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/tool-use-agent-cfg.svg
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/tool-use-agent-cfg.svg
diff --git a/python/packages/autogen-core/docs/src/user-guide/guides/tools.ipynb b/python/packages/autogen-core/docs/src/core-user-guide/guides/tools.ipynb
similarity index 100%
rename from python/packages/autogen-core/docs/src/user-guide/guides/tools.ipynb
rename to python/packages/autogen-core/docs/src/core-user-guide/guides/tools.ipynb
diff --git a/python/packages/autogen-core/docs/src/core-user-guide/index.md b/python/packages/autogen-core/docs/src/core-user-guide/index.md
new file mode 100644
index 000000000..6981f7726
--- /dev/null
+++ b/python/packages/autogen-core/docs/src/core-user-guide/index.md
@@ -0,0 +1,98 @@
+---
+myst:
+ html_meta:
+ "description lang=en": |
+ User Guide for AutoGen Core, a framework for building multi-agent applications with AI agents.
+---
+
+# Core
+
+```{warning}
+This project and documentation is a work in progress. If you have any questions or need help, please reach out to us on GitHub.
+```
+
+AutoGen core offers an easy way to quickly build event-driven, distributed, scalable, resilient AI agent systems. Agents are developed by using the [Actor model](https://en.wikipedia.org/wiki/Actor_model). You can build and run your agent system locally and easily move to a distributed system in the cloud when you are ready.
+
+Key features of AutoGen core include:
+
+```{gallery-grid}
+:grid-columns: 1 2 2 3
+
+- header: "{fas}`network-wired;pst-color-primary` Asynchronous Messaging"
+ content: "Agents communicate through asynchronous messages, enabling event-driven and request/response communication models."
+- header: "{fas}`cube;pst-color-primary` Scalable & Distributed"
+ content: "Enable complex scenarios with networks of agents across organizational boundaries."
+- header: "{fas}`code;pst-color-primary` Multi-Language Support"
+ content: "Python & Dotnet interoperating agents today, with more languages coming soon."
+- header: "{fas}`globe;pst-color-primary` Modular & Extensible"
+ content: "Highly customizable with features like custom agents, memory as a service, tools registry, and model library."
+- header: "{fas}`puzzle-piece;pst-color-primary` Observable & Debuggable"
+ content: "Easily trace and debug your agent systems."
+- header: "{fas}`project-diagram;pst-color-primary` Event-Driven Architecture"
+ content: "Build event-driven, distributed, scalable, and resilient AI agent systems."
+```
+
+```{toctree}
+:caption: Getting Started
+:maxdepth: 1
+:hidden:
+
+guides/installation
+guides/quickstart
+```
+
+```{toctree}
+:caption: Core Concepts
+:maxdepth: 1
+:hidden:
+
+
+core-concepts/agent-and-multi-agent-application
+core-concepts/architecture
+core-concepts/api-layers
+core-concepts/application-stack
+core-concepts/agent-identity-and-lifecycle
+core-concepts/topic-and-subscription
+core-concepts/faqs
+
+```
+
+```{toctree}
+:caption: Framework
+:maxdepth: 1
+:hidden:
+
+guides/agent-and-agent-runtime
+guides/message-and-communication
+guides/model-clients
+guides/tools
+guides/logging
+guides/distributed-agent-runtime
+guides/telemetry
+guides/command-line-code-executors
+```
+
+```{toctree}
+:caption: Multi-Agent Design Patterns
+:maxdepth: 1
+:hidden:
+
+guides/multi-agent-design-patterns
+guides/group-chat
+guides/reflection
+```
+
+```{toctree}
+:caption: Cookbook
+:maxdepth: 1
+:hidden:
+
+cookbook/azure-openai-with-aad-auth
+cookbook/termination-with-intervention
+cookbook/extracting-results-with-an-agent
+cookbook/openai-assistant-agent
+cookbook/langgraph-agent
+cookbook/llamaindex-agent
+cookbook/local-llms-ollama-litellm
+
+```
diff --git a/python/packages/autogen-core/docs/src/index.md b/python/packages/autogen-core/docs/src/index.md
index 245e2857f..3709dc762 100644
--- a/python/packages/autogen-core/docs/src/index.md
+++ b/python/packages/autogen-core/docs/src/index.md
@@ -6,30 +6,78 @@ myst:
html_theme.sidebar_secondary.remove: false
---
-# AutoGen
-
-AutoGen is an OSS framework for developing intelligent applications using AI Agents patterns.
-It offers an easy way to quickly build event-driven, distributed, scalable, resilient AI agent systems. Agents are developed by using the [Actor model](https://en.wikipedia.org/wiki/Actor_model). You can build and run your agent system locally and easily move to a distributed system in the cloud when you are ready.
-
-Key features of AutoGen are summarized below.
-
-```{gallery-grid}
-:grid-columns: 1 2 2 3
-
-- header: "{fas}`network-wired;pst-color-primary` Asynchronous Messaging"
- content: "Agents communicate through asynchronous messages, enabling event-driven and request/response communication models."
-- header: "{fas}`cube;pst-color-primary` Scalable & Distributed"
- content: "Enable complex scenarios with networks of agents across organizational boundaries."
-- header: "{fas}`code;pst-color-primary` Multi-Language Support"
- content: "Python & Dotnet interoperating agents today, with more languages coming soon."
-- header: "{fas}`globe;pst-color-primary` Modular & Extensible"
- content: "Highly customizable with features like custom agents, memory as a service, tools registry, and model library."
-- header: "{fas}`puzzle-piece;pst-color-primary` Observable & Debuggable"
- content: "Easily trace and debug your agent systems."
-- header: "{fas}`project-diagram;pst-color-primary` Event-Driven Architecture"
- content: "Build event-driven, distributed, scalable, and resilient AI agent systems."
+<style>
+.hero-title {
+ font-size: 60px;
+ font-weight: bold;
+ margin: 2rem auto 0;
+}
+</style>
+
+<div class="container">
+
+<div class="row text-center">
+<div class="col-sm-12">
+<h1 class="hero-title">
+AutoGen
+</h1>
+<h3>
+A framework for developing intelligent applications using AI agent patterns.
+</h3>
+</div>
+</div>
+
+
+<div class="row">
+
+<div class="col-sm">
+<h2 class="text-center">
+
+{fas}`people-group;pst-color-primary` AgentChat
+
+</h2>
+
+<p>
+Task driven, high level APIs for building multi-agent systems. Including group chat, pre-built agents, and more.
+
+Built with <i>core</i>.
+<p>
+
+```sh
+pip install autogen-agentchat
```
+<button onclick="location.href='agentchat-user-guide/guides/quickstart.html'" type="button" class="btn btn-primary">Get Started</button>
+<button onclick="location.href='reference/python/autogen_agentchat/autogen_agentchat.html'" type="button" class="btn btn-outline-secondary">API Reference</button>
+
+<div class="versionadded">
+<p>Start here if you are looking for an API similar to AutoGen 0.2</p>
+</div>
+
+</div>
+<div class="col-sm">
+<h2 class="text-center">
+
+{fas}`cube;pst-color-primary` Core
+
+</h2>
+
+<p>
+Primitive building blocks for creating asynchronous, event driven multi-agent systems.
+<p>
+
+```sh
+pip install autogen-core
+```
+
+<button onclick="location.href='core-user-guide/guides/quickstart.html'" type="button" class="btn btn-primary">Get Started</button>
+<button onclick="location.href='reference/python/autogen_core/autogen_core.html'" type="button" class="btn btn-outline-secondary">API Reference</button>
+
+</div>
+
+</div>
+</div>
+
<!--
Key features of AutoGen include:
@@ -39,15 +87,12 @@ Key features of AutoGen include:
- x-lang support: Python & Dotnet interoperating agents today, others coming soon
- Observable, traceable & debuggable -->
-```{seealso}
-To start quickly, read the [Quick Start](user-guide/guides/quickstart) guide and follow the tutorial sections. To learn about the core concepts of AutoGen, begin with [Agent and Multi-Agent Application](user-guide/core-concepts/agent-and-multi-agent-application).
-```
-
```{toctree}
:maxdepth: 1
:hidden:
-user-guide/index
+agentchat-user-guide/index
+core-user-guide/index
```
<!-- ## Community
diff --git a/python/packages/autogen-core/docs/src/packages/index.md b/python/packages/autogen-core/docs/src/packages/index.md
index 73da83900..5c0896a77 100644
--- a/python/packages/autogen-core/docs/src/packages/index.md
+++ b/python/packages/autogen-core/docs/src/packages/index.md
@@ -20,31 +20,30 @@ myst:
# Packages
-:::{card} {fas}`cube;pst-color-primary` AutoGen Core
+:::{card} {fas}`people-group;pst-color-primary` AutoGen AgentChat
:class-title: card-title
-Implements the core functionality of the AutoGen framework, providing basic building blocks for creating multi-agent systems.
+Library that is at a similar level of abstraction as AutoGen 0.2, including default agents and group chat.
```sh
-pip install autogen-core
+pip install autogen-agentchat
```
-[{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-core/) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_core/autogen_core.rst) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/agnext/tree/main/python/packages/autogen-core)
+[{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-agentchat/) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_agentchat/autogen_agentchat.rst) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/agnext/tree/main/python/packages/autogen-agentchat)
:::
-:::{card} {fas}`people-group;pst-color-primary` AutoGen AgentChat
+:::{card} {fas}`cube;pst-color-primary` AutoGen Core
:class-title: card-title
-Library that is at a similar level of abstraction as AutoGen 0.2, including default agents and group chat.
+Implements the core functionality of the AutoGen framework, providing basic building blocks for creating multi-agent systems.
```sh
-pip install autogen-agentchat
+pip install autogen-core
```
-[{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-agentchat/) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_agentchat/autogen_agentchat.rst) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/agnext/tree/main/python/packages/autogen-agentchat)
+[{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-core/) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_core/autogen_core.rst) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/agnext/tree/main/python/packages/autogen-core)
:::
-
:::{card} {fas}`puzzle-piece;pst-color-primary` AutoGen Extensions
:class-title: card-title
diff --git a/python/packages/autogen-core/docs/src/reference/index.md b/python/packages/autogen-core/docs/src/reference/index.md
index deb2b5988..97a692cc2 100644
--- a/python/packages/autogen-core/docs/src/reference/index.md
+++ b/python/packages/autogen-core/docs/src/reference/index.md
@@ -22,16 +22,16 @@ myst:
```{toctree}
:hidden:
-:caption: AutoGen Core
+:caption: AutoGen AgentChat
-python/autogen_core/autogen_core
+python/autogen_agentchat/autogen_agentchat
```
```{toctree}
:hidden:
-:caption: AutoGen AgentChat
+:caption: AutoGen Core
-python/autogen_agentchat/autogen_agentchat
+python/autogen_core/autogen_core
```
```{toctree}
@@ -46,14 +46,14 @@ python/autogen_ext/autogen_ext.tools
:margin: 4 4 0 0
:gutter: 1
-:::{grid-item-card} {fas}`cube;pst-color-primary` <br> AutoGen Core
-:link: python/autogen_core/autogen_core
+:::{grid-item-card} {fas}`people-group;pst-color-primary` <br> AutoGen AgentChat
+:link: python/autogen_agentchat/autogen_agentchat
:link-type: doc
:class-item: api-card
:::
-:::{grid-item-card} {fas}`people-group;pst-color-primary` <br> AutoGen AgentChat
-:link: python/autogen_agentchat/autogen_agentchat
+:::{grid-item-card} {fas}`cube;pst-color-primary` <br> AutoGen Core
+:link: python/autogen_core/autogen_core
:link-type: doc
:class-item: api-card
:::
diff --git a/python/packages/autogen-core/docs/src/user-guide/index.md b/python/packages/autogen-core/docs/src/user-guide/index.md
deleted file mode 100644
index 6b5e7c2cb..000000000
--- a/python/packages/autogen-core/docs/src/user-guide/index.md
+++ /dev/null
@@ -1,79 +0,0 @@
----
-myst:
- html_meta:
- "description lang=en": |
- User Guide for AutoGen, a framework for building multi-agent applications with AI agents.
----
-
-# User Guide
-
-AutoGen is a flexible framework for building multi-agent systems. Begin with the [installation](guides/installation.md) guide to set up the framework on your machine. Then, follow the [quickstart](guides/quickstart) guide to get started with building your first multi-agent application.
-
-```{danger}
-This project and documentation is a work in progress. If you have any questions or need help, please reach out to us on GitHub.
-```
-
-```{toctree}
-:caption: Getting Started
-:maxdepth: 1
-:hidden:
-
-guides/installation
-guides/quickstart
-```
-
-```{toctree}
-:caption: Core Concepts
-:maxdepth: 1
-:hidden:
-
-
-core-concepts/agent-and-multi-agent-application
-core-concepts/architecture
-core-concepts/api-layers
-core-concepts/application-stack
-core-concepts/agent-identity-and-lifecycle
-core-concepts/topic-and-subscription
-core-concepts/faqs
-
-```
-
-```{toctree}
-:caption: Framework
-:maxdepth: 1
-:hidden:
-
-guides/agent-and-agent-runtime
-guides/message-and-communication
-guides/model-clients
-guides/tools
-guides/logging
-guides/distributed-agent-runtime
-guides/telemetry
-guides/command-line-code-executors
-```
-
-```{toctree}
-:caption: Multi-Agent Design Patterns
-:maxdepth: 1
-:hidden:
-
-guides/multi-agent-design-patterns
-guides/group-chat
-guides/reflection
-```
-
-```{toctree}
-:caption: Cookbook
-:maxdepth: 1
-:hidden:
-
-cookbook/azure-openai-with-aad-auth
-cookbook/termination-with-intervention
-cookbook/extracting-results-with-an-agent
-cookbook/openai-assistant-agent
-cookbook/langgraph-agent
-cookbook/llamaindex-agent
-cookbook/local-llms-ollama-litellm
-
-```