#
課程簡介

歡迎來到 Hugging Face 課程！這個簡介將引導您設定工作環境。如果您剛開始學習這門課程，我們建議您先查看第一章然後回來設定您的環境，這樣您就可以親自嘗試程式碼。

我們在這門課程中使用的所有函式庫都可以作為 Python 套件取得，因此我們將向您展示如何設定 Python 環境並安裝您需要的特定函式庫。

我們將介紹兩種設定工作環境的方法 - 使用 Colab notebook 或是 Python 虛擬環境。請隨意選擇最適合您的方法。對於初學者，我們強烈建議您使用 Colab notebook 開始學習。

請注意，我們不會涵蓋 Windows 系統。如果您使用的是 Windows，我們建議您使用 Colab 筆記本跟著學習。如果您使用的是 Linux 發行版或 macOS，您可以使用這裡描述的任一種方法。

這門課程的大部分內容都需要您擁有 Hugging Face 帳戶。我們建議您現在就建立一個建立帳戶。

##
使用 Google Colab notebook

使用 Colab notebook 是最簡單的設定方式；在您的瀏覽器中啟動 Colab notebook 就能直接開始寫程式了！

如果您不熟悉 Colab notebook 不熟悉的話，我們建議您先閱讀簡介開始。Colab 允許您使用一些加速硬體，如 GPU 或 TPU，對於較小的工作負載是免費的。

一旦您熟悉了 Colab 的操作，請建立一個新的 notebook 並開始設定：

下一步是安裝我們在這門課程中將使用的函式庫。我們將使用 `pip` 進行安裝，這是 Python 的套件管理器。在 Colab notebook 中，您可以在系統指令前加上 `!` 字元來執行，因此您可以如下安裝 🤗 Transformers 函式庫：

    !pip install transformers

您可以透過在 Python 執行環境中匯入來確保套件已正確安裝：

    import transformers

這會安裝一個非常輕量版本的 🤗 Transformers。特別是，不會安裝特定的機器學習框架（如 PyTorch 或 TensorFlow）。由於我們將使用函式庫的許多不同功能，我們建議安裝開發版本，它包含幾乎任何可想像用例所需的所有相依套件：

    !pip install transformers[sentencepiece]

這需要一些時間，但之後您就準備好進行課程的其餘部分了！

##
使用 Python 虛擬環境

如果您偏好使用 Python 虛擬環境，第一步是在您的系統上安裝 Python。我們建議遵循這篇指南開始。

一旦您安裝了 Python，您應該能夠在終端機中執行 Python 指令。在進行下一步之前，您可以先執行以下指令來確保它已正確安裝：`python --version` 這應該會印出您系統上現在可用的 Python 版本。

當您在終端機中執行 Python 指令（如`python --version`）時，您應該將執行指令的程式視為您系統上的「主要」Python。我們建議保持這個主要安裝不安裝任何套件，並使用它為您工作的每個應用程式建立獨立的環境——這樣，每個應用程式都可以擁有自己的相依套件，您也不需要擔心與其他應用程式的潛在相容性問題。

在 Python 中，這是透過虛擬環境來實現的，虛擬環境是自包含的目錄樹，每個都包含特定 Python 版本的 Python 安裝以及應用程式所需的所有套件。建立這樣的虛擬環境可以使用許多不同的工具，但我們將使用官方的 Python 套件，稱為`venv`。

首先，建立您希望應用程式所在的目錄 - 例如，您可能想在您的家目錄根目錄下建立一個名為 transformers-course 的新目錄：

    mkdir ~/transformers-course
    cd ~/transformers-course

從這個目錄內部，使用 Python `venv` 模組建立虛擬環境：

    python -m venv .env

您現在應該在原本空的資料夾中有一個名為 .env 的目錄：

    ls -a

    .      ..    .env

您可以使用 `activate` 和 `deactivate` 腳本進入和退出虛擬環境：

    # Activate the virtual environment
    source .env/bin/activate

    # Deactivate the virtual environment
    deactivate

您可以透過執行 `which python` 指令來確保環境已啟動：如果它指向虛擬環境，那麼您已成功啟動它！

    which python

    /home/<user>/transformers-course/.env/bin/python

###
安裝相依套件

如同前面關於使用 Google Colab 實例的章節，您現在需要安裝繼續所需的套件。同樣地，您可以使用 `pip` 套件管理器安裝 🤗 Transformers 的開發版本：

    pip install "transformers[sentencepiece]"

您現在已經完成設定並準備就緒！

< > Update on GitHub