From 292d0bda86b830f1c98b9a7b47338f572de2e3e8 Mon Sep 17 00:00:00 2001
From: Anix Lynch <anixlynch@gmail.com>
Date: Tue, 10 Mar 2026 07:54:06 -0700
Subject: [PATCH] docs(huggingface): add [full] install guidance and
 sentence-transformers>=5.2.0 migration note (#35713)

---
 libs/partners/huggingface/README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/libs/partners/huggingface/README.md b/libs/partners/huggingface/README.md
index 2d3b46f9c22..05e54897352 100644
--- a/libs/partners/huggingface/README.md
+++ b/libs/partners/huggingface/README.md
@@ -13,6 +13,22 @@ Looking for the JS/TS version? Check out [LangChain.js](https://github.com/langc
 pip install langchain-huggingface
 ```
 
+> **Note:** The base install does not include `sentence-transformers` or `transformers`.
+> If you plan to use `HuggingFaceEmbeddings` or `HuggingFacePipeline` for **local inference**,
+> install the `[full]` extra which includes `sentence-transformers>=5.2.0` and `transformers>=5.0.0`:
+>
+> ```bash
+> pip install langchain-huggingface[full]
+> ```
+>
+> **Migrating from `langchain-community`?** Note that `langchain-community` accepted
+> `sentence-transformers>=2.2.0`, but `langchain-huggingface[full]` requires `>=5.2.0`.
+> If your project pins an older version, upgrade it:
+>
+> ```bash
+> pip install "sentence-transformers>=5.2.0"
+> ```
+
 ## 🤔 What is this?
 
 This package contains the LangChain integrations for Hugging Face related classes.