# מבוא

ברוכים הבאים לקורס של Hugging Face! מבוא זה ידריך אתכם בהתקנת סביבת העבודה. אם אתם רק מתחילים את הקורס, אנחנו ממליצים שקודם תעברו על פרק 1, ואז תחזרו לכאן כדי להתקין את סביבת העבודה שלכם ותתנסו בכתיבת קוד בעצמכם.

כל הספריות בהן נשתמש בקורס זה זמינות כספריות Python, לכן כאן נראה לכם איך להקים סביבת עבודה של Python ואיך להתקין את הספריות הספציפיות שאותן תצטרכו.

נכסה שתי דרכים להקים את סביבת העבודה, שימוש במחברת Colab או בסביבת עבודה וירטואלית של Python. תרגישו חופשיים לבחור את השיטה שמתאימה לכם ביותר. עבור מתחילים, אנחנו ממליצים בחום שתתחילו בשימוש במחברת Colab.

שימו לב שלא נכסה שימוש במערת הפעלה Windows. אם אתם מריצים על Windows, אנחנו ממליצים להשתמש במחברות Colab. אם אתם משתמשים ב Linux או ב macOS, תוכלו לבחור באחת מהשיטות המוצעות כאן.

רוב הקורס מתבסס על כך שיש לכם חשבון Hugging Face. תוכלו ליצור אחד כאן: יצירת משתמש.

##
שימוש במחברת Google Colab

שימוש במחברת Colab היא הדרך הפשוטה ביותר להתקנה; פתחו מחברת Colab בדפדפן שלכם ותתחילו לכתוב קוד!

אם אתם לא מכירים את Colab, אנחנו ממליצים שתתחילו לעבור על המבוא. Colab מאפשר לעבוד על חומרה כמו GPUs או TPUs, והשירות ניתן בחינם לפרויקטים קטנים.

כשאתם מרגישים בנוח לנווט ב Colab, פתחו מחברת חדשה והתחילו בהקמת הסביבה:

הצעד הבא הוא התקנת כל הספריות שנצטרך בקורס. נשתמש ב `pip` להתקנה, שהוא מנהל החבילות ב Python. במחברות, אפשר להריץ פקודות מערכת ע”י כתיבה של `!` לפניהן, לכן אפשר להתקין את ספריית ה 🤗 Transformers בצורה הבאה:

    !pip install transformers

תוכלו לוודא שחבילה הותקנה בצהלחה על ידי ביצוע import שלה לסביבת הריצה שלכם:

    import transformers

פקודה זו מתקינה גרסה קלה מאוד של 🤗 Transformers. בפרט, לא מותקנות frameworks כגון PyTorch או TensorFlow. מכיוון שנשתמש בהרבה פיצ’רים של הספריה, אנחנו ממליצים להתקין את גרסת הפיתוח, שמגיעה עם כל ה dependencies הדרושים כמעט לכל תרחיש אפשרי:

    !pip install transformers[sentencepiece]

ההתקנה תמשך זמן מה, אבל לאחר מכן תהיו מוכנים לשאר הקורס.

##
שימוש בסביבה וירטואלית של Python

אם אתם מעדיפים להשתמש בסביבה וירטואלית של Python, הצעד הראשון יהיה להתקין Python במערכת שלכם. אנחנו ממליצים על המדריך הזה כדי להתחיל.

לאחר ש Python מותקן, אתם אמורים להצליח להריץ פקודות Python מהטרמינל. תוכלו להתחיל על ידי הרצה של הפקודה הבאה כדי לוודא שההתקנה הצליחה לפני שתעברו לשלבים הבאים: `python --version` . זה אמור להציג את גרסת ה Python שזמינה במערכת שלכם כרגע.

בהרצת פקודת Python בטרמינל, כמו `python --version`, מומלץ לחשוב על התוכנה שמריצה את הפקודות כ “Python” המרכזי במערכת שלכם. אנחנו ממליצים לשמור על ההתקנה המרכזית הזו נקייה מחבילות, ולהשתמש בה כדי ליצור סביבות נפרדות לכל יישום שתעבדו עליו - כך, לכל יישום יהיו החבילות וה dependencies שלה ולא תצטרכו לדאוג מבעיות תאימות עם יישומים אחרים.

ב Python זה מבוצע בעזרת סביבות וירטואליות, שהן עצי תיקיות עצמאיים וכל אחת מהן מכילה התקנת Python נפרדת עם כל החבילות שיישום צריך. יצירת סביבה וירטואלית יכולה להעשות בעזרת מגוון כלים, אנחנו נשתמש בחבילת ה Python הרשמית, שנקראת `venv`.

תחילה, צרו את התיקייה בה תרצו שהיישום שלכם יחיה — לדוגמה, אולי תרצו ליצור תיקייה חדשה בשם transformers-course בשורש תיקייה הבית שלכם:

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

מתוך תיקייה זו, צרו סביבה וירטואלית על ידי שימוש במודול `venv`:

    python -m venv .env

עכשיו אמורה להיות לכם תיקייה בשם env. בתיקייה שהייתה ריקה מקודם:

    ls -a

    .      ..    .env

תוכלו להכנס ולצאת מהסביבה הוירטואלית שלכם בעזרת הפקודות `activate` ו `deactivate` :

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

    # Deactivate the virtual environment
    source .env/bin/deactivate

תוכלו לוודא שהסביבה הוירטואלית שלכם פעילה על ידי הרצת הפקודה `which python` : אם היא מצביעה על הסביבה הוירטואלית, אז הפעלתם אותה בהצלחה!

    which python

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

###
התקנת dependencies

בדומה לחלק על שימוש ב Google Colab, תצטרכו להתקין את החבילות הנדרשות להמשך. שוב, תוכלו להתקין את גרסת הפיתוח של 🤗 Transformers בעזרת מנהל החבילות `pip`:

    pip install "transformers[sentencepiece]"

עכשיו אתם מוכנים להמשך הקורס!