From d3219b5e93360b8668bfb657c5be9e74d4e71d1b Mon Sep 17 00:00:00 2001
From: Evan Mattson <35585003+moonbox3@users.noreply.github.com>
Date: Wed, 1 Oct 2025 10:12:56 +0900
Subject: [PATCH] Python: Clarifications on installing packages in README
 (#1036)

* Clarifications on installing packages in README

* Updates
---
 python/README.md | 31 +++++++++++++++++++++++++++----
 1 file changed, 27 insertions(+), 4 deletions(-)

diff --git a/python/README.md b/python/README.md
index 7dc97bb137..0e79f85c33 100644
--- a/python/README.md
+++ b/python/README.md
@@ -2,17 +2,40 @@
 
 ## Quick Install
 
+We recommend two common installation paths depending on your use case.
+
+### 1. Development mode
+
+If you are exploring or developing locally, install the entire framework with all sub-packages:
+
 ```bash
-# Install agent-framework-core and all sub packages
 pip install agent-framework
-# Install only core and Azure AI integration
+```
+
+This installs the core and every integration package, making sure that all features are available without additional steps. This is the simplest way to get started.
+
+### 2. Selective install
+
+If you only need specific integrations, you can install at a more granular level. This keeps dependencies lighter and focuses on what you actually plan to use. Some examples:
+
+```bash
+# Core only
+# includes Azure OpenAI and OpenAI support by default
+# also includes workflows and orchestrations
+pip install agent-framework-core
+
+# Core + Azure AI integration
 pip install agent-framework-azure-ai
-# Install only core and Microsoft Copilot Studio integration
+
+# Core + Microsoft Copilot Studio integration
 pip install agent-framework-copilotstudio
-# Install only core, Microsoft Copilot Studio and Azure AI integration
+
+# Core + both Microsoft Copilot Studio and Azure AI integration
 pip install agent-framework-microsoft agent-framework-azure-ai
 ```
 
+This selective approach is useful when you know which integrations you need, and it is the recommended way to set up lightweight environments.
+
 Supported Platforms:
 
 - Python: 3.10+