Hub 文件
在 Hugging Face 使用 spaCy
並獲得增強的文件體驗
開始使用
在 Hugging Face 使用 spaCy
spaCy 是一個流行的先進自然語言處理庫，廣泛應用於工業界。spaCy 使得使用和訓練用於命名實體識別、文字分類、詞性標註等任務的管道變得容易，並允許您構建強大的應用程式來處理和分析大量文字。
在 Hub 中探索 spaCy 模型
spaCy 3.3 的官方模型在 spaCy 的組織頁面。社群中的任何人也可以分享他們的 spaCy 模型，您可以透過在模型頁面左側進行篩選來找到它們。
Hub 上的所有模型都附帶了有用的功能
- 一個自動生成的模型卡，包含標籤方案、指標、元件等。
- 右上角有一個評估部分，您可以在其中檢視指標。
- 元資料標籤有助於發現幷包含許可證和語言等資訊。
- 一個互動式小部件，您可以在瀏覽器中直接使用該模型進行操作
- 允許進行推理請求的推理 API。
使用現有模型
Hub 中的所有 spaCy 模型都可以直接使用 pip install 進行安裝。
pip install "en_core_web_sm @ https://huggingface.co/spacy/en_core_web_sm/resolve/main/en_core_web_sm-any-py3-none-any.whl"要找到感興趣的連結，您可以訪問包含 spaCy 模型的倉庫。開啟倉庫後，您可以點選 Use in spaCy，然後會得到一個可用於安裝和載入模型的工作程式碼片段！
安裝後，您可以像載入任何 spaCy 管道一樣載入模型。
# Using spacy.load().
import spacy
nlp = spacy.load("en_core_web_sm")
# Importing as module.
import en_core_web_sm
nlp = en_core_web_sm.load()分享您的模型
使用 spaCy CLI（推薦）
spacy-huggingface-hub 庫擴充套件了 spaCy 原生 CLI，以便使用者可以輕鬆地將其打包的模型推送到 Hub。
您可以從 pip 安裝 spacy-huggingface-hub
pip install spacy-huggingface-hub
然後您可以檢查命令是否成功註冊
python -m spacy huggingface-hub --help要使用 CLI 推送，您可以使用如下所示的 huggingface-hub push 命令。
python -m spacy huggingface-hub push [whl_path] [--org] [--msg] [--local-repo] [--verbose]
| 引數 | 型別 | 描述 |
|---|---|---|
whl_path | str / Path | 使用 spacy package 打包的 .whl 檔案的路徑。 |
--org, -o | 字串 | 要上傳管道的組織的可選名稱。 |
--msg, -m | 字串 | 用於更新的提交訊息。預設為 "Update spaCy pipeline"。 |
--local-repo, -l | str / Path | 模型倉庫的本地路徑（如果不存在則建立）。預設為當前工作目錄中的 hub。 |
--verbose, -V | 布林值 | 輸出用於除錯的額外資訊，例如完整的生成中心元資料。 |
然後，您可以上傳任何使用 spacy package 打包的管道。請確保設定 --build wheel 以輸出二進位制 .whl 檔案。上傳器將從管道包中讀取所有元資料，包括自動生成的漂亮 README.md 和 meta.json 中可用的模型詳細資訊。
hf auth login
python -m spacy package ./en_ner_fashion ./output --build wheel
cd ./output/en_ner_fashion-0.0.0/dist
python -m spacy huggingface-hub push en_ner_fashion-0.0.0-py3-none-any.whl只需一分鐘，您就可以將打包好的模型上傳到 Hub，直接在瀏覽器中試用，並與社群其他成員分享。所有必需的元資料都會為您上傳，您甚至會得到一個很酷的模型卡片。
該命令將輸出兩項內容
- 在 Hub 中查詢您的倉庫的位置！例如，https://huggingface.co/spacy/en_core_web_sm
- 以及如何直接從 Hub 安裝管道！
從 Python 指令碼
您可以使用 Python 中的 push 函式。它返回一個字典，其中包含已釋出模型和 wheel 檔案的 "url" 和 “whl_url”，您以後可以使用 pip install 進行安裝。
from spacy_huggingface_hub import push
result = push("./en_ner_fashion-0.0.0-py3-none-any.whl")
print(result["url"])