From 353769fbf06a36a2307a9e67038c483ded7426d0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 30 Jan 2026 14:15:11 +0000
Subject: [PATCH 1/6] Initial plan


From e4e881b7468bfa18611fcfd2c4773d3c9a8248dd Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 30 Jan 2026 14:20:18 +0000
Subject: [PATCH 2/6] Add Python hosting integration article and restructure
 sidebar

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
---
 .../config/sidebar/integrations.topics.ts     |  15 +-
 .../docs/get-started/deploy-first-app.mdx     |  12 +
 .../content/docs/get-started/first-app.mdx    |   6 +
 .../python-community-toolkit.mdx}             |  14 +-
 .../frameworks/python/python-host.mdx         | 294 ++++++++++++++++++
 5 files changed, 337 insertions(+), 4 deletions(-)
 rename src/frontend/src/content/docs/integrations/frameworks/{python.mdx => python/python-community-toolkit.mdx} (80%)
 create mode 100644 src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx

diff --git a/src/frontend/config/sidebar/integrations.topics.ts b/src/frontend/config/sidebar/integrations.topics.ts
index 528e7a6f..cdda7d8a 100644
--- a/src/frontend/config/sidebar/integrations.topics.ts
+++ b/src/frontend/config/sidebar/integrations.topics.ts
@@ -786,7 +786,20 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
         { label: 'Node.js extensions', slug: 'integrations/frameworks/nodejs-extensions' },
         { label: 'Orleans', slug: 'integrations/frameworks/orleans' },
         { label: 'PowerShell', slug: 'integrations/frameworks/powershell' },
-        { label: 'Python', slug: 'integrations/frameworks/python' },
+        {
+          label: 'Python',
+          collapsed: true,
+          items: [
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/frameworks/python/python-host',
+            },
+            {
+              label: 'Community extensions',
+              slug: 'integrations/frameworks/python/python-community-toolkit',
+            },
+          ],
+        },
         { label: 'Rust', slug: 'integrations/frameworks/rust' },
       ],
     },
diff --git a/src/frontend/src/content/docs/get-started/deploy-first-app.mdx b/src/frontend/src/content/docs/get-started/deploy-first-app.mdx
index 752f092c..ae24d027 100644
--- a/src/frontend/src/content/docs/get-started/deploy-first-app.mdx
+++ b/src/frontend/src/content/docs/get-started/deploy-first-app.mdx
@@ -189,6 +189,12 @@ In the AppHost, chain a call to the appropriate environment API method to config
         - `AddDockerComposeEnvironment` — Configures the Docker Compose environment for deployment. This call implicitly adds support for containerizing resources in the AppHost as part of deployment.
         - `WithExternalHttpEndpoints` — Exposes HTTP endpoints for the resource when deployed.
 
+        <Aside type="tip">
+
+        Learn more about Python hosting integration features and deployment in the [Python Hosting integration](/integrations/frameworks/python/python-host) article.
+
+        </Aside>
+
     </TabItem>
     <TabItem id="azure" label="Azure">
 
@@ -241,6 +247,12 @@ In the AppHost, chain a call to the appropriate environment API method to config
         - `AddAzureContainerAppEnvironment` — Configures the Azure App Container environment for deployment. This call implicitly adds support for containerizing resources in the AppHost as part of deployment.
         - `WithExternalHttpEndpoints` — Exposes HTTP endpoints for the resource when deployed.
 
+        <Aside type="tip">
+
+        Learn more about Python hosting integration features and deployment in the [Python Hosting integration](/integrations/frameworks/python/python-host) article.
+
+        </Aside>
+
     </TabItem>
 </Tabs>
 
diff --git a/src/frontend/src/content/docs/get-started/first-app.mdx b/src/frontend/src/content/docs/get-started/first-app.mdx
index dd69bd02..bd9c083e 100644
--- a/src/frontend/src/content/docs/get-started/first-app.mdx
+++ b/src/frontend/src/content/docs/get-started/first-app.mdx
@@ -248,6 +248,12 @@ To create your first Aspire application, use the [Aspire CLI](/get-started/insta
     - `WaitFor` ensures the API starts before the frontend
     - `PublishWithContainerFiles` bundles the frontend for production deployment
 
+    <Aside type="tip">
+
+    Learn more about Python hosting integration features like `AddPythonApp`, `AddPythonModule`, and virtual environment management in the [Python Hosting integration](/integrations/frameworks/python/python-host) article.
+
+    </Aside>
+
     </Pivot>
 
     <Aside type="note" title="Code-first orchestration">
diff --git a/src/frontend/src/content/docs/integrations/frameworks/python.mdx b/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
similarity index 80%
rename from src/frontend/src/content/docs/integrations/frameworks/python.mdx
rename to src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
index be031c84..4a576f45 100644
--- a/src/frontend/src/content/docs/integrations/frameworks/python.mdx
+++ b/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
@@ -1,5 +1,6 @@
 ---
-title: Python integration
+title: Python Community extensions
+description: Learn how to use the Aspire Community Toolkit Python hosting extensions to run Python applications with Uvicorn and uv package manager.
 ---
 
 import { Badge } from '@astrojs/starlight/components';
@@ -19,7 +20,13 @@ import pythonIcon from '@assets/icons/python.svg';
   data-zoom-off
 />
 
-The Aspire Python hosting integration enables you to run Python applications alongside your Aspire projects in the Aspire app host. This integration supports both [Uvicorn](https://www.uvicorn.org/) applications and [uv](https://docs.astral.sh/uv/) package manager applications.
+The Aspire Community Toolkit Python hosting extensions provide additional functionality to the official [Aspire.Hosting.Python](/integrations/frameworks/python/python-host) hosting integration. This package adds support for [Uvicorn](https://www.uvicorn.org/) applications with additional configuration options and [uv](https://docs.astral.sh/uv/) package manager applications.
+
+<Aside type="tip">
+
+For general Python hosting capabilities, see the [Python Hosting integration](/integrations/frameworks/python/python-host) article which covers the official `Aspire.Hosting.Python` package.
+
+</Aside>
 
 ## Hosting integration
 
@@ -104,8 +111,9 @@ By default, the working directory is set to the `projectDirectory` specified whe
 
 ## See also
 
+- [Python Hosting integration](/integrations/frameworks/python/python-host)
 - [Uvicorn documentation](https://www.uvicorn.org/)
 - [uv documentation](https://docs.astral.sh/uv/)
 - [Aspire Community Toolkit](https://github.com/CommunityToolkit/Aspire)
-- [Aspire integrations overview](overview.md)
+- [Aspire integrations overview](/integrations/overview/)
 - [Aspire GitHub repo](https://github.com/dotnet/aspire)
diff --git a/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx b/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
new file mode 100644
index 00000000..6aeb7618
--- /dev/null
+++ b/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
@@ -0,0 +1,294 @@
+---
+title: Python Hosting integration
+description: Learn how to use the Aspire Python Hosting integration to orchestrate Python applications in an Aspire solution.
+---
+
+import { Image } from 'astro:assets';
+import InstallPackage from '@components/InstallPackage.astro';
+import { Aside, Code, Steps } from '@astrojs/starlight/components';
+import pythonIcon from '@assets/icons/python.svg';
+
+<Image
+  src={pythonIcon}
+  alt="Python logo"
+  width={100}
+  height={100}
+  class:list={'float-inline-left icon'}
+  data-zoom-off
+/>
+
+The Aspire Python hosting integration enables you to run Python applications alongside your Aspire projects in the Aspire app host. This integration provides first-class support for Python apps, scripts, modules, executables, and web frameworks like FastAPI.
+
+## Installation
+
+To access these types and APIs for expressing Python resources in your [`AppHost`](/get-started/app-host/) project, install the [📦 Aspire.Hosting.Python](https://www.nuget.org/packages/Aspire.Hosting.Python) NuGet package:
+
+<InstallPackage packageName="Aspire.Hosting.Python" />
+
+## Add Python app
+
+To add a Python application to your app host, use the `AddPythonApp` extension method to run a Python script:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonApp(
+    name: "python-api",
+    projectDirectory: "../python-app",
+    scriptPath: "main.py")
+    .WithHttpEndpoint(port: 8000, env: "PORT");
+
+builder.AddProject<Projects.ExampleProject>()
+       .WithReference(python);
+
+// After adding all resources, run the app...
+```
+
+The `AddPythonApp` method requires:
+- **name**: The name of the resource in the Aspire dashboard
+- **projectDirectory**: The path to the directory containing your Python application
+- **scriptPath**: The path to the Python script to run (relative to the project directory)
+
+## Add Python module
+
+To run a Python module (using `python -m`), use the `AddPythonModule` extension method:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonModule(
+    name: "python-module",
+    projectDirectory: "../python-app",
+    moduleName: "mymodule")
+    .WithHttpEndpoint(port: 8000, env: "PORT");
+
+// After adding all resources, run the app...
+```
+
+The `AddPythonModule` method requires:
+- **name**: The name of the resource in the Aspire dashboard
+- **projectDirectory**: The path to the directory containing your Python application
+- **moduleName**: The name of the Python module to run
+
+## Add Python executable
+
+To run a Python executable or CLI tool from a virtual environment, use the `AddPythonExecutable` extension method:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonExecutable(
+    name: "python-tool",
+    projectDirectory: "../python-app",
+    executable: "uvicorn",
+    args: ["main:app", "--host", "0.0.0.0", "--port", "8000"]);
+
+// After adding all resources, run the app...
+```
+
+## Add Uvicorn app
+
+For ASGI web frameworks like FastAPI, Starlette, and Quart, use the `AddUvicornApp` extension method which provides built-in support for Uvicorn:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddUvicornApp(
+    name: "python-api",
+    projectDirectory: "../python-app",
+    appName: "main:app")
+    .WithHttpEndpoint(port: 8000, env: "PORT");
+
+builder.AddProject<Projects.ExampleProject>()
+       .WithReference(python);
+
+// After adding all resources, run the app...
+```
+
+The `AddUvicornApp` method requires:
+- **name**: The name of the resource in the Aspire dashboard
+- **projectDirectory**: The path to the directory containing your Python application
+- **appName**: The Python module and ASGI application instance (e.g., `main:app` for an `app` instance in `main.py`)
+
+### Uvicorn configuration
+
+The `AddUvicornApp` method supports additional configuration options:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddUvicornApp("python-api", "../python-app", "main:app")
+    .WithHttpEndpoint(port: 8000, env: "PORT")
+    .WithEnvironment("UVICORN_WORKERS", "4")
+    .WithEnvironment("UVICORN_LOG_LEVEL", "info");
+
+// After adding all resources, run the app...
+```
+
+Common Uvicorn environment variables:
+- **UVICORN_PORT**: The port to listen on
+- **UVICORN_HOST**: The host to bind to (default: `127.0.0.1`)
+- **UVICORN_WORKERS**: Number of worker processes
+- **UVICORN_LOG_LEVEL**: Logging level (e.g., `debug`, `info`, `warning`, `error`)
+
+## Virtual environment management
+
+The Python hosting integration automatically detects and manages Python virtual environments:
+
+### Automatic virtual environment
+
+By default, the integration looks for a virtual environment in the project directory. If a `requirements.txt` or `pyproject.toml` file is found, it will automatically create and activate a virtual environment.
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+// Automatically detects and uses virtual environment
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py");
+
+// After adding all resources, run the app...
+```
+
+### Custom virtual environment
+
+To specify a custom virtual environment location, use the `WithVirtualEnvironment` method:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
+    .WithVirtualEnvironment("../python-app/.venv");
+
+// After adding all resources, run the app...
+```
+
+### Disable virtual environment
+
+To disable automatic virtual environment creation, use the `WithoutVirtualEnvironment` method:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
+    .WithoutVirtualEnvironment();
+
+// After adding all resources, run the app...
+```
+
+## Configure endpoints
+
+Python applications typically use environment variables to configure the port they listen on. Use `WithHttpEndpoint` to configure the port and set the environment variable:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddUvicornApp("python-api", "../python-app", "main:app")
+    .WithHttpEndpoint(port: 8000, env: "PORT");
+
+// After adding all resources, run the app...
+```
+
+### Multiple endpoints
+
+You can configure multiple endpoints for a Python application:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
+    .WithHttpEndpoint(port: 8000, env: "HTTP_PORT", name: "http")
+    .WithHttpEndpoint(port: 8443, env: "HTTPS_PORT", name: "https");
+
+// After adding all resources, run the app...
+```
+
+## Health checks
+
+The Python hosting integration supports health checks for monitoring service health:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddUvicornApp("python-api", "../python-app", "main:app")
+    .WithHttpEndpoint(port: 8000, env: "PORT")
+    .WithHttpHealthCheck("/health");
+
+// After adding all resources, run the app...
+```
+
+## Environment variables
+
+Pass environment variables to your Python application using the `WithEnvironment` method:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
+    .WithEnvironment("DEBUG", "true")
+    .WithEnvironment("LOG_LEVEL", "debug");
+
+// After adding all resources, run the app...
+```
+
+## Service discovery
+
+Python applications can reference other services in the Aspire app host using service discovery:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var postgres = builder.AddPostgres("postgres")
+    .AddDatabase("mydb");
+
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
+    .WithReference(postgres);
+
+// After adding all resources, run the app...
+```
+
+The connection string will be available as an environment variable in the Python application.
+
+## Debugging
+
+The Python hosting integration provides full debugging support in Visual Studio Code:
+
+1. Install the [Aspire VS Code extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.dotnet-aspire)
+2. Set breakpoints in your Python code
+3. Run the Aspire app host
+4. The debugger will automatically attach to your Python application
+
+<Aside type="tip">
+
+The Aspire VS Code extension automatically generates launch configurations for Python applications in your Aspire solution, enabling zero-configuration debugging.
+
+</Aside>
+
+## Deployment
+
+When deploying your Aspire application, the Python hosting integration automatically generates production-ready Dockerfiles for your Python services:
+
+```dockerfile
+# Auto-generated Dockerfile
+FROM python:3.12-slim
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install -r requirements.txt
+
+COPY . .
+CMD ["python", "main.py"]
+```
+
+<Aside type="note">
+
+The generated Dockerfile is tailored to your detected Python version and dependency setup, ensuring optimal compatibility and performance.
+
+</Aside>
+
+## See also
+
+- [Python Community Toolkit integration](/integrations/frameworks/python/python-community-toolkit)
+- [Build your first Aspire app](/get-started/first-app/)
+- [Deploy your first Aspire app](/get-started/deploy-first-app/)
+- [Aspire integrations overview](/integrations/overview/)
+- [Aspire.Hosting.Python NuGet package](https://www.nuget.org/packages/Aspire.Hosting.Python)
+- [Aspire GitHub repo](https://github.com/dotnet/aspire)

From 06c8b937288090b2e14900d8fb984896a24f8b38 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 30 Jan 2026 14:30:38 +0000
Subject: [PATCH 3/6] Fix Python documentation based on code review feedback

- Mark Community Toolkit package as deprecated with migration guide
- Add WithUv() and WithPip() package manager documentation
- Fix method name reference from AddUv to WithUv in first-app.mdx
- Clarify that AddUvicornApp is part of official package

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
---
 .../content/docs/get-started/first-app.mdx    |   2 +-
 .../python/python-community-toolkit.mdx       | 115 ++++++++----------
 .../frameworks/python/python-host.mdx         |  40 ++++++
 3 files changed, 91 insertions(+), 66 deletions(-)

diff --git a/src/frontend/src/content/docs/get-started/first-app.mdx b/src/frontend/src/content/docs/get-started/first-app.mdx
index bd9c083e..6450186b 100644
--- a/src/frontend/src/content/docs/get-started/first-app.mdx
+++ b/src/frontend/src/content/docs/get-started/first-app.mdx
@@ -242,7 +242,7 @@ To create your first Aspire application, use the [Aspire CLI](/get-started/insta
     _What's happening here?_
     
     - `AddUvicornApp` adds a Uvicorn-based Python app
-    - `AddUv` adds a Uv environment setup task: `uv sync`
+    - `WithUv` adds a Uv environment setup task: `uv sync`
     - `AddViteApp` registers your React frontend
     - `WithReference` connects the frontend to the API
     - `WaitFor` ensures the API starts before the frontend
diff --git a/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx b/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
index 4a576f45..34d8f60b 100644
--- a/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
+++ b/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
@@ -1,6 +1,6 @@
 ---
 title: Python Community extensions
-description: Learn how to use the Aspire Community Toolkit Python hosting extensions to run Python applications with Uvicorn and uv package manager.
+description: Learn about the Community Toolkit Python hosting extensions (deprecated in favor of official Aspire.Hosting.Python).
 ---
 
 import { Badge } from '@astrojs/starlight/components';
@@ -10,6 +10,7 @@ import { Image } from 'astro:assets';
 import pythonIcon from '@assets/icons/python.svg';
 
 <Badge text="⭐ Community Toolkit" variant="tip" size="large" />
+<Badge text="⚠️ Deprecated" variant="caution" size="large" />
 
 <Image
   src={pythonIcon}
@@ -20,100 +21,84 @@ import pythonIcon from '@assets/icons/python.svg';
   data-zoom-off
 />
 
-The Aspire Community Toolkit Python hosting extensions provide additional functionality to the official [Aspire.Hosting.Python](/integrations/frameworks/python/python-host) hosting integration. This package adds support for [Uvicorn](https://www.uvicorn.org/) applications with additional configuration options and [uv](https://docs.astral.sh/uv/) package manager applications.
+<Aside type="caution" title="Deprecated Package">
 
-<Aside type="tip">
+As of Aspire 13, the functionality from **CommunityToolkit.Aspire.Hosting.Python.Extensions** has been incorporated into the official [Aspire.Hosting.Python](/integrations/frameworks/python/python-host) package. This Community Toolkit package is now deprecated.
 
-For general Python hosting capabilities, see the [Python Hosting integration](/integrations/frameworks/python/python-host) article which covers the official `Aspire.Hosting.Python` package.
+**Please use the official [Python Hosting integration](/integrations/frameworks/python/python-host) for all new development.**
 
 </Aside>
 
-## Hosting integration
+The Aspire Community Toolkit Python hosting extensions package was a community-driven effort that provided Python hosting capabilities before official support was available in Aspire. With Aspire 13, Python became a first-class workload with all these features now built into the official package.
 
-To get started with the Aspire Python hosting integration, install the [CommunityToolkit.Aspire.Hosting.Python.Extensions](https://www.nuget.org/packages/CommunityToolkit.Aspire.Hosting.Python.Extensions) NuGet package in the app host project.
+## Migration Guide
 
-<InstallPackage packageName="CommunityToolkit.Aspire.Hosting.Python.Extensions" />
+If you're currently using `CommunityToolkit.Aspire.Hosting.Python.Extensions`, follow these steps to migrate:
 
-### Add Uvicorn app
+### 1. Update Package References
 
-To add a Uvicorn application to your app host, use the `AddUvicornApp` extension method:
+Remove the Community Toolkit package and install the official package:
 
-```csharp title="C# — AppHost.cs"
-var builder = DistributedApplication.CreateBuilder(args);
+```xml title="AppHost.csproj"
+<!-- Remove this -->
+<PackageReference Include="CommunityToolkit.Aspire.Hosting.Python.Extensions" Version="*" />
 
-var python = builder.AddUvicornApp(
-    name: "python-api",
-    projectDirectory: "../python-app",
-    appName: "main:app")
-    .WithHttpEndpoint(port: 8000, env: "PORT");
-
-builder.AddProject<Projects.ExampleProject>()
-       .WithReference(python);
-
-// After adding all resources, run the app...
+<!-- Add this -->
+<PackageReference Include="Aspire.Hosting.Python" Version="13.0.0" />
 ```
 
-The `AddUvicornApp` method requires:
-- **name**: The name of the resource in the Aspire dashboard
-- **projectDirectory**: The path to the directory containing your Python application
-- **appName**: The Python module and ASGI application instance (e.g., `main:app` for an `app` instance in `main.py`)
+<InstallPackage packageName="Aspire.Hosting.Python" />
 
-<Aside type="note">
+### 2. Update Using Statements
 
-The Python application requires a virtual environment. Make sure you have created and activated a virtual environment in your Python project directory before running the app host.
+Replace Community Toolkit imports with official package imports:
 
-</Aside>
+```csharp
+// Remove this
+using CommunityToolkit.Aspire.Hosting.Python.Extensions;
 
-### Add uv app
-
-To add an application using the [uv package manager](https://docs.astral.sh/uv/), use the `AddUvApp` extension method:
+// Add this (if not already present)
+using Aspire.Hosting;
+```
 
-```csharp title="C# — AppHost.cs"
-var builder = DistributedApplication.CreateBuilder(args);
+### 3. Update Method Calls
 
-var python = builder.AddUvApp(
-    name: "python-api",
-    projectDirectory: "../python-app",
-    scriptPath: "main.py")
-    .WithHttpEndpoint(port: 8000, env: "PORT");
+The API is largely the same, but resource types have changed:
 
-builder.AddProject<Projects.ExampleProject>()
-       .WithReference(python);
+**AddUvicornApp:**
+```csharp
+// Before (Community Toolkit)
+var python = builder.AddUvicornApp("python-api", "../python-app", "main:app");
 
-// After adding all resources, run the app...
+// After (Official - same API)
+var python = builder.AddUvicornApp("python-api", "../python-app", "main:app");
 ```
 
-The `AddUvApp` method requires:
-- **name**: The name of the resource in the Aspire dashboard
-- **projectDirectory**: The path to the directory containing your Python application
-- **scriptPath**: The path to the Python script to run (relative to the project directory)
-
-### Configure endpoints
-
-Python applications typically use environment variables to configure the port they listen on. Use `WithHttpEndpoint` to configure the port and set the environment variable:
-
-```csharp title="C# — AppHost.cs"
-var builder = DistributedApplication.CreateBuilder(args);
+**AddUvApp:**
+```csharp
+// Before (Community Toolkit)  
+var python = builder.AddUvApp("python-api", "../python-app", "main.py");
 
+// After (Official - use WithUv() method)
 var python = builder.AddUvicornApp("python-api", "../python-app", "main:app")
-    .WithHttpEndpoint(port: 8000, env: "UVICORN_PORT");
-
-// After adding all resources, run the app...
+    .WithUv();
 ```
 
-Common environment variables for Python web frameworks:
-- **UVICORN_PORT**: For Uvicorn applications
-- **PORT**: Generic port configuration used by many frameworks
+### Benefits of Migration
 
-### Working directory
+The official package provides:
 
-By default, the working directory is set to the `projectDirectory` specified when adding the Python app. The integration will look for the Python virtual environment and dependencies in this directory.
+- ✅ **Better Integration**: Full support in Visual Studio and VS Code
+- ✅ **Automatic Virtual Environments**: Smarter venv detection and management  
+- ✅ **More Features**: Additional methods like `AddPythonApp`, `AddPythonModule`, `AddPythonExecutable`
+- ✅ **Active Maintenance**: Regular updates and bug fixes from the Aspire team
+- ✅ **Unified Experience**: Consistent API with other Aspire hosting packages
+- ✅ **Debugging Support**: Zero-config debugging in VS Code
+- ✅ **Automatic Dockerization**: Production-ready Dockerfile generation
 
 ## See also
 
-- [Python Hosting integration](/integrations/frameworks/python/python-host)
-- [Uvicorn documentation](https://www.uvicorn.org/)
-- [uv documentation](https://docs.astral.sh/uv/)
-- [Aspire Community Toolkit](https://github.com/CommunityToolkit/Aspire)
+- [Python Hosting integration](/integrations/frameworks/python/python-host) - Official Python support in Aspire
+- [Aspire 13 Python announcement](https://devblogs.microsoft.com/aspire/python-is-first-class-in-aspire-13/)
+- [Aspire Community Toolkit GitHub](https://github.com/CommunityToolkit/Aspire)
 - [Aspire integrations overview](/integrations/overview/)
-- [Aspire GitHub repo](https://github.com/dotnet/aspire)
diff --git a/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx b/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
index 6aeb7618..28a5803d 100644
--- a/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
+++ b/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
@@ -174,6 +174,46 @@ var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
 // After adding all resources, run the app...
 ```
 
+## Package management
+
+The Python hosting integration supports multiple package managers and allows you to choose which one to use:
+
+### Using uv package manager
+
+Use the `WithUv()` method to explicitly use the [uv package manager](https://docs.astral.sh/uv/) for faster dependency installation:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddUvicornApp("python-api", "../python-app", "main:app")
+    .WithUv()
+    .WithHttpEndpoint(port: 8000, env: "PORT");
+
+// After adding all resources, run the app...
+```
+
+The `WithUv()` method configures the Python app to use uv for package management, which is significantly faster than pip and recommended for new projects.
+
+### Using pip package manager
+
+Use the `WithPip()` method to explicitly use pip for package management:
+
+```csharp title="C# — AppHost.cs"
+var builder = DistributedApplication.CreateBuilder(args);
+
+var python = builder.AddPythonApp("python-api", "../python-app", "main.py")
+    .WithPip()
+    .WithHttpEndpoint(port: 8000, env: "PORT");
+
+// After adding all resources, run the app...
+```
+
+<Aside type="tip">
+
+If neither `WithUv()` nor `WithPip()` is specified, Aspire will automatically detect the appropriate package manager based on your project configuration (`pyproject.toml` for uv, `requirements.txt` for pip).
+
+</Aside>
+
 ## Configure endpoints
 
 Python applications typically use environment variables to configure the port they listen on. Use `WithHttpEndpoint` to configure the port and set the environment variable:

From c3ebefef7473a3b557d9a14099065914aa914ad6 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 30 Jan 2026 15:44:15 +0000
Subject: [PATCH 4/6] Rewrite Python integration to use official
 Aspire.Hosting.Python package

Remove Community Toolkit references and nested structure.
Update python.mdx in place with official package documentation.

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
---
 .../config/sidebar/integrations.topics.ts     |  15 +--
 .../docs/get-started/deploy-first-app.mdx     |  12 --
 .../content/docs/get-started/first-app.mdx    |   8 +-
 .../{python/python-host.mdx => python.mdx}    |   9 +-
 .../python/python-community-toolkit.mdx       | 104 ------------------
 5 files changed, 7 insertions(+), 141 deletions(-)
 rename src/frontend/src/content/docs/integrations/frameworks/{python/python-host.mdx => python.mdx} (98%)
 delete mode 100644 src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx

diff --git a/src/frontend/config/sidebar/integrations.topics.ts b/src/frontend/config/sidebar/integrations.topics.ts
index cdda7d8a..528e7a6f 100644
--- a/src/frontend/config/sidebar/integrations.topics.ts
+++ b/src/frontend/config/sidebar/integrations.topics.ts
@@ -786,20 +786,7 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
         { label: 'Node.js extensions', slug: 'integrations/frameworks/nodejs-extensions' },
         { label: 'Orleans', slug: 'integrations/frameworks/orleans' },
         { label: 'PowerShell', slug: 'integrations/frameworks/powershell' },
-        {
-          label: 'Python',
-          collapsed: true,
-          items: [
-            {
-              label: 'Hosting integration (AppHost)',
-              slug: 'integrations/frameworks/python/python-host',
-            },
-            {
-              label: 'Community extensions',
-              slug: 'integrations/frameworks/python/python-community-toolkit',
-            },
-          ],
-        },
+        { label: 'Python', slug: 'integrations/frameworks/python' },
         { label: 'Rust', slug: 'integrations/frameworks/rust' },
       ],
     },
diff --git a/src/frontend/src/content/docs/get-started/deploy-first-app.mdx b/src/frontend/src/content/docs/get-started/deploy-first-app.mdx
index ae24d027..752f092c 100644
--- a/src/frontend/src/content/docs/get-started/deploy-first-app.mdx
+++ b/src/frontend/src/content/docs/get-started/deploy-first-app.mdx
@@ -189,12 +189,6 @@ In the AppHost, chain a call to the appropriate environment API method to config
         - `AddDockerComposeEnvironment` — Configures the Docker Compose environment for deployment. This call implicitly adds support for containerizing resources in the AppHost as part of deployment.
         - `WithExternalHttpEndpoints` — Exposes HTTP endpoints for the resource when deployed.
 
-        <Aside type="tip">
-
-        Learn more about Python hosting integration features and deployment in the [Python Hosting integration](/integrations/frameworks/python/python-host) article.
-
-        </Aside>
-
     </TabItem>
     <TabItem id="azure" label="Azure">
 
@@ -247,12 +241,6 @@ In the AppHost, chain a call to the appropriate environment API method to config
         - `AddAzureContainerAppEnvironment` — Configures the Azure App Container environment for deployment. This call implicitly adds support for containerizing resources in the AppHost as part of deployment.
         - `WithExternalHttpEndpoints` — Exposes HTTP endpoints for the resource when deployed.
 
-        <Aside type="tip">
-
-        Learn more about Python hosting integration features and deployment in the [Python Hosting integration](/integrations/frameworks/python/python-host) article.
-
-        </Aside>
-
     </TabItem>
 </Tabs>
 
diff --git a/src/frontend/src/content/docs/get-started/first-app.mdx b/src/frontend/src/content/docs/get-started/first-app.mdx
index 6450186b..dd69bd02 100644
--- a/src/frontend/src/content/docs/get-started/first-app.mdx
+++ b/src/frontend/src/content/docs/get-started/first-app.mdx
@@ -242,18 +242,12 @@ To create your first Aspire application, use the [Aspire CLI](/get-started/insta
     _What's happening here?_
     
     - `AddUvicornApp` adds a Uvicorn-based Python app
-    - `WithUv` adds a Uv environment setup task: `uv sync`
+    - `AddUv` adds a Uv environment setup task: `uv sync`
     - `AddViteApp` registers your React frontend
     - `WithReference` connects the frontend to the API
     - `WaitFor` ensures the API starts before the frontend
     - `PublishWithContainerFiles` bundles the frontend for production deployment
 
-    <Aside type="tip">
-
-    Learn more about Python hosting integration features like `AddPythonApp`, `AddPythonModule`, and virtual environment management in the [Python Hosting integration](/integrations/frameworks/python/python-host) article.
-
-    </Aside>
-
     </Pivot>
 
     <Aside type="note" title="Code-first orchestration">
diff --git a/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx b/src/frontend/src/content/docs/integrations/frameworks/python.mdx
similarity index 98%
rename from src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
rename to src/frontend/src/content/docs/integrations/frameworks/python.mdx
index 28a5803d..9f197b80 100644
--- a/src/frontend/src/content/docs/integrations/frameworks/python/python-host.mdx
+++ b/src/frontend/src/content/docs/integrations/frameworks/python.mdx
@@ -1,11 +1,11 @@
 ---
-title: Python Hosting integration
+title: Python integration
 description: Learn how to use the Aspire Python Hosting integration to orchestrate Python applications in an Aspire solution.
 ---
 
-import { Image } from 'astro:assets';
+import { Aside } from '@astrojs/starlight/components';
 import InstallPackage from '@components/InstallPackage.astro';
-import { Aside, Code, Steps } from '@astrojs/starlight/components';
+import { Image } from 'astro:assets';
 import pythonIcon from '@assets/icons/python.svg';
 
 <Image
@@ -326,9 +326,10 @@ The generated Dockerfile is tailored to your detected Python version and depende
 
 ## See also
 
-- [Python Community Toolkit integration](/integrations/frameworks/python/python-community-toolkit)
 - [Build your first Aspire app](/get-started/first-app/)
 - [Deploy your first Aspire app](/get-started/deploy-first-app/)
 - [Aspire integrations overview](/integrations/overview/)
 - [Aspire.Hosting.Python NuGet package](https://www.nuget.org/packages/Aspire.Hosting.Python)
+- [Uvicorn documentation](https://www.uvicorn.org/)
+- [uv package manager documentation](https://docs.astral.sh/uv/)
 - [Aspire GitHub repo](https://github.com/dotnet/aspire)
diff --git a/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx b/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
deleted file mode 100644
index 34d8f60b..00000000
--- a/src/frontend/src/content/docs/integrations/frameworks/python/python-community-toolkit.mdx
+++ /dev/null
@@ -1,104 +0,0 @@
----
-title: Python Community extensions
-description: Learn about the Community Toolkit Python hosting extensions (deprecated in favor of official Aspire.Hosting.Python).
----
-
-import { Badge } from '@astrojs/starlight/components';
-import { Aside } from '@astrojs/starlight/components';
-import InstallPackage from "@components/InstallPackage.astro";
-import { Image } from 'astro:assets';
-import pythonIcon from '@assets/icons/python.svg';
-
-<Badge text="⭐ Community Toolkit" variant="tip" size="large" />
-<Badge text="⚠️ Deprecated" variant="caution" size="large" />
-
-<Image
-  src={pythonIcon}
-  alt="Python logo"
-  width={100}
-  height={100}
-  class:list={'float-inline-left icon'}
-  data-zoom-off
-/>
-
-<Aside type="caution" title="Deprecated Package">
-
-As of Aspire 13, the functionality from **CommunityToolkit.Aspire.Hosting.Python.Extensions** has been incorporated into the official [Aspire.Hosting.Python](/integrations/frameworks/python/python-host) package. This Community Toolkit package is now deprecated.
-
-**Please use the official [Python Hosting integration](/integrations/frameworks/python/python-host) for all new development.**
-
-</Aside>
-
-The Aspire Community Toolkit Python hosting extensions package was a community-driven effort that provided Python hosting capabilities before official support was available in Aspire. With Aspire 13, Python became a first-class workload with all these features now built into the official package.
-
-## Migration Guide
-
-If you're currently using `CommunityToolkit.Aspire.Hosting.Python.Extensions`, follow these steps to migrate:
-
-### 1. Update Package References
-
-Remove the Community Toolkit package and install the official package:
-
-```xml title="AppHost.csproj"
-<!-- Remove this -->
-<PackageReference Include="CommunityToolkit.Aspire.Hosting.Python.Extensions" Version="*" />
-
-<!-- Add this -->
-<PackageReference Include="Aspire.Hosting.Python" Version="13.0.0" />
-```
-
-<InstallPackage packageName="Aspire.Hosting.Python" />
-
-### 2. Update Using Statements
-
-Replace Community Toolkit imports with official package imports:
-
-```csharp
-// Remove this
-using CommunityToolkit.Aspire.Hosting.Python.Extensions;
-
-// Add this (if not already present)
-using Aspire.Hosting;
-```
-
-### 3. Update Method Calls
-
-The API is largely the same, but resource types have changed:
-
-**AddUvicornApp:**
-```csharp
-// Before (Community Toolkit)
-var python = builder.AddUvicornApp("python-api", "../python-app", "main:app");
-
-// After (Official - same API)
-var python = builder.AddUvicornApp("python-api", "../python-app", "main:app");
-```
-
-**AddUvApp:**
-```csharp
-// Before (Community Toolkit)  
-var python = builder.AddUvApp("python-api", "../python-app", "main.py");
-
-// After (Official - use WithUv() method)
-var python = builder.AddUvicornApp("python-api", "../python-app", "main:app")
-    .WithUv();
-```
-
-### Benefits of Migration
-
-The official package provides:
-
-- ✅ **Better Integration**: Full support in Visual Studio and VS Code
-- ✅ **Automatic Virtual Environments**: Smarter venv detection and management  
-- ✅ **More Features**: Additional methods like `AddPythonApp`, `AddPythonModule`, `AddPythonExecutable`
-- ✅ **Active Maintenance**: Regular updates and bug fixes from the Aspire team
-- ✅ **Unified Experience**: Consistent API with other Aspire hosting packages
-- ✅ **Debugging Support**: Zero-config debugging in VS Code
-- ✅ **Automatic Dockerization**: Production-ready Dockerfile generation
-
-## See also
-
-- [Python Hosting integration](/integrations/frameworks/python/python-host) - Official Python support in Aspire
-- [Aspire 13 Python announcement](https://devblogs.microsoft.com/aspire/python-is-first-class-in-aspire-13/)
-- [Aspire Community Toolkit GitHub](https://github.com/CommunityToolkit/Aspire)
-- [Aspire integrations overview](/integrations/overview/)

From e71c12e4b8e314548671472776142a2974649798 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 30 Jan 2026 16:30:47 +0000
Subject: [PATCH 5/6] Fix merge conflict - remove Community Toolkit references
 and add Aspire 13 note

---
 .../content/docs/integrations/frameworks/python.mdx    | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/frontend/src/content/docs/integrations/frameworks/python.mdx b/src/frontend/src/content/docs/integrations/frameworks/python.mdx
index 7777c747..37148bed 100644
--- a/src/frontend/src/content/docs/integrations/frameworks/python.mdx
+++ b/src/frontend/src/content/docs/integrations/frameworks/python.mdx
@@ -19,6 +19,12 @@ import pythonIcon from '@assets/icons/python.svg';
 
 The Aspire Python hosting integration enables you to run Python applications alongside your Aspire projects in the Aspire app host. This integration provides first-class support for Python apps, scripts, modules, executables, and web frameworks like FastAPI.
 
+<Aside type="tip">
+
+As of Aspire 13, Python is a first-class workload with full support for debugging, service discovery, and deployment alongside .NET and JavaScript applications.
+
+</Aside>
+
 ## Installation
 
 To access these types and APIs for expressing Python resources in your [`AppHost`](/get-started/app-host/) project, install the [📦 Aspire.Hosting.Python](https://www.nuget.org/packages/Aspire.Hosting.Python) NuGet package:
@@ -331,7 +337,5 @@ The generated Dockerfile is tailored to your detected Python version and depende
 - [Aspire integrations overview](/integrations/overview/)
 - [Aspire.Hosting.Python NuGet package](https://www.nuget.org/packages/Aspire.Hosting.Python)
 - [Uvicorn documentation](https://www.uvicorn.org/)
-- [uv documentation](https://docs.astral.sh/uv/)
-- [Aspire Community Toolkit](https://github.com/CommunityToolkit/Aspire)
-- [Aspire integrations overview](/integrations/overview/)
+- [uv package manager documentation](https://docs.astral.sh/uv/)
 - [Aspire GitHub repo](https://github.com/dotnet/aspire)

From f87adc748e929b8c8f6e5ca1b5ee46492b0dea9f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 30 Jan 2026 16:58:35 +0000
Subject: [PATCH 6/6] Add Community Toolkit deprecation notice to Python
 integration

Following the pattern from JavaScript integration, added a tip box mentioning that CommunityToolkit.Aspire.Hosting.Python.Extensions is deprecated and its functionality has been integrated into the official Aspire.Hosting.Python package in Aspire 13.

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
---
 .../src/content/docs/integrations/frameworks/python.mdx   | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/frontend/src/content/docs/integrations/frameworks/python.mdx b/src/frontend/src/content/docs/integrations/frameworks/python.mdx
index 37148bed..56fea5f3 100644
--- a/src/frontend/src/content/docs/integrations/frameworks/python.mdx
+++ b/src/frontend/src/content/docs/integrations/frameworks/python.mdx
@@ -19,11 +19,9 @@ import pythonIcon from '@assets/icons/python.svg';
 
 The Aspire Python hosting integration enables you to run Python applications alongside your Aspire projects in the Aspire app host. This integration provides first-class support for Python apps, scripts, modules, executables, and web frameworks like FastAPI.
 
-<Aside type="tip">
-
-As of Aspire 13, Python is a first-class workload with full support for debugging, service discovery, and deployment alongside .NET and JavaScript applications.
-
-</Aside>
+:::tip[First-class Python support]
+As of Aspire 13, Python is a first-class workload with the `Aspire.Hosting.Python` package. The previous `CommunityToolkit.Aspire.Hosting.Python.Extensions` package is deprecated, and its functionality has been integrated into the official package with full support for debugging, service discovery, and deployment alongside .NET and JavaScript applications.
+:::
 
 ## Installation