clarification

hengtaoguo · hengtaoguo · commit b5a2eb584a24 · 2025-12-06T05:51:39.000Z
diff --git a/docs/install_maxtext.md b/docs/install_maxtext.md
@@ -159,6 +159,8 @@ install_maxtext_github_deps
 
 ## Appendix: Install XPK for Multi-host Workloads
 
+**Note:** XPK is only required for multi-host TPU configurations (e.g., v5p-128, v6e-256). For single-host training, XPK is not needed and you can run MaxText directly on your TPU VM.
+
 XPK (Accelerated Processing Kit) is a tool designed to simplify the orchestration and management of workloads on Google Kubernetes Engine (GKE) clusters with TPU or GPU accelerators. In MaxText, we use XPK to submit both pre-training and post-training jobs on multi-host TPU configurations.
 
 For your convenience, we provide a minimal installation path below:
