Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 51 additions & 0 deletions chapters/mr/chapter 0/1.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# परिचय[[introduction]]

हगिंग फेस (Hugging Face) कोर्समध्ये आपले स्वागत आहे! हा परिचय तुम्हाला तुमचे वर्किंग एन्व्हायर्नमेंट (working environment) सेट करण्यासाठी मार्गदर्शन करेल. जर तुम्ही हा कोर्स नुकताच सुरू करत असाल, तर आम्ही शिफारस करतो की तुम्ही आधी [प्रकरण १](/course/chapter1) पहावे, आणि नंतर परत येऊन तुमचे एन्व्हायर्नमेंट सेट करावे म्हणजे तुम्ही स्वतः कोड चालवून पाहू शकाल.

या कोर्समध्ये आपण वापरणार असलेल्या सर्व लायब्ररीज पायथन पॅकेजेस (Python packages) म्हणून उपलब्ध आहेत, त्यामुळे आपण येथे पायथन एन्व्हायर्नमेंट कसे सेट करायचे आणि आवश्यक असलेल्या विशिष्ट लायब्ररीज कशा इन्स्टॉल करायच्या हे पाहणार आहोत.

आपण तुमचे वर्किंग एन्व्हायर्नमेंट सेट करण्याच्या दोन पद्धती पाहणार आहोत: कोलॅब नोटबुक (Colab notebook) वापरणे किंवा पायथन व्हर्च्युअल एन्व्हायर्नमेंट (Python virtual environment) वापरणे. तुम्हाला सर्वात योग्य वाटेल अशी पद्धत तुम्ही निवडू शकता. नवशिक्यांसाठी (beginners), आम्ही कोलॅब नोटबुक वापरून सुरुवात करण्याची जोरदार शिफारस करतो.

लक्षात घ्या की आपण विंडोज सिस्टीम कव्हर करणार नाही आहोत. जर तुम्ही विंडोज वापरत असाल, तर आम्ही तुम्हाला कोलॅब नोटबुक वापरूनच हा कोर्स पुढे चालू ठेवण्याची शिफारस करतो. जर तुम्ही लिनक्स (Linux) डिस्ट्रिब्युशन किंवा मॅकओएस (macOS) वापरत असाल, तर तुम्ही येथे वर्णन केलेल्या दोनपैकी कोणतीही पद्धत वापरू शकता.

कोर्सचा बहुतांश भाग तुमच्याकडे हगिंग फेस अकाउंट असण्यावर अवलंबून आहे. आम्ही आताच एक तयार करण्याची शिफारस करतो: [खाते तयार करा](https://huggingface.co/join).

## गुगल कोलॅब नोटबुक वापरणे[[using-a-google-colab-notebook]]

कोलॅब नोटबुक वापरणे हा सर्वात सोपा सेटअप आहे; तुमच्या ब्राउझरमध्ये नोटबुक सुरू करा आणि थेट कोडिंगला लागा!

जर तुम्हाला कोलॅबची माहिती नसेल, तर आम्ही [परिचय](https://colab.research.google.com/notebooks/intro.ipynb) वाचून सुरुवात करण्याची शिफारस करतो. कोलॅब तुम्हाला GPU किंवा TPU सारखे काही प्रवेगक हार्डवेअर (accelerating hardware) वापरण्याची परवानगी देते, आणि ते लहान वर्कलोड्ससाठी मोफत आहे.

एकदा तुम्हाला कोलॅबची चांगली ओळख झाल्यावर, नवीन नोटबुक तयार करा आणि सेटअपला सुरुवात करा:

<div class="flex justify-center">
<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>
</div>

पुढची पायरी म्हणजे या कोर्समध्ये आपण ज्या लायब्ररीज वापरणार आहोत त्या इन्स्टॉल करणे. आपण इन्स्टॉलेशनसाठी `pip` वापरू, जे पायथनसाठी पॅकेज मॅनेजर आहे. नोटबुक्समध्ये, तुम्ही सिस्टीम कमांड्सच्या आधी `!` चिन्ह लावून त्या रन करू शकता, जेणेकरून तुम्ही 🤗 ट्रान्सफॉर्मर्स (Transformers) लायब्ररी खालीलप्रमाणे इन्स्टॉल करू शकाल:
तुम्ही तुमच्या पायथन रनटाइममध्ये पॅकेज इम्पोर्ट (import) करून ते योग्यरीत्या इन्स्टॉल झाले आहे की नाही याची खात्री करू शकता:
<div class="flex justify-center">
<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/install.gif" alt="A gif showing the result of the two commands above: installation and import" width="80%"/>
</div>

यामुळे 🤗 ट्रान्सफॉर्मर्सची अतिशय हलकी (light) आवृत्ती इन्स्टॉल होते. विशेषतः, कोणतेही विशिष्ट मशीन लर्निंग फ्रेमवर्क (जसे की PyTorch किंवा TensorFlow) यात इन्स्टॉल केलेले नाहीत. आपण या लायब्ररीची बरीच वेगळी वैशिष्ट्ये वापरणार असल्याने, आम्ही डेव्हलपमेंट व्हर्जन (development version) इन्स्टॉल करण्याची शिफारस करतो, जे जवळजवळ कोणत्याही संभाव्य युज केससाठी (use case) सर्व आवश्यक डिपेंडन्सीज (dependencies) सोबत येते:
यासाठी थोडा वेळ लागेल, पण त्यानंतर तुम्ही उर्वरित कोर्ससाठी सज्ज व्हाल!

## पायथन व्हर्च्युअल एन्व्हायर्नमेंट वापरणे[[using-a-python-virtual-environment]]

जर तुम्ही पायथन व्हर्च्युअल एन्व्हायर्नमेंट वापरण्यास प्राधान्य देत असाल, तर पहिली पायरी म्हणजे तुमच्या सिस्टीमवर पायथन इन्स्टॉल करणे. सुरुवातीसाठी आम्ही [या मार्गदर्शकाचे](https://realpython.com/installing-python/) पालन करण्याची शिफारस करतो.

एकदा तुम्ही पायथन इन्स्टॉल केल्यानंतर, तुम्ही तुमच्या टर्मिनलमध्ये पायथन कमांड्स चालवू शकाल. पुढील पायऱ्यांवर जाण्यापूर्वी ते योग्यरीत्या इन्स्टॉल झाले आहे याची खात्री करण्यासाठी तुम्ही खालील कमांड रन करून सुरुवात करू शकता: `python --version`. हे तुमच्या सिस्टीमवर आता उपलब्ध असलेली पायथन आवृत्ती प्रिंट करेल.

जेव्हा तुम्ही तुमच्या टर्मिनलमध्ये एखादी पायथन कमांड चालवता, जसे की `python --version`, तेव्हा तुम्ही तुमच्या सिस्टीमवरील "मुख्य" (main) पायथन म्हणून तुमची कमांड चालवणाऱ्या प्रोग्रामचा विचार केला पाहिजे. आम्ही शिफारस करतो की हे मुख्य इन्स्टॉलेशन कोणत्याही पॅकेजेसपासून मुक्त ठेवा, आणि तुम्ही काम करत असलेल्या प्रत्येक ॲप्लिकेशनसाठी वेगळे एन्व्हायर्नमेंट तयार करण्यासाठी त्याचा वापर करा — अशा प्रकारे, प्रत्येक ॲप्लिकेशनच्या स्वतःच्या डिपेंडन्सीज आणि पॅकेजेस असू शकतात आणि तुम्हाला इतर ॲप्लिकेशन्ससोबतच्या संभाव्य कंपॅटिबिलिटीच्या (compatibility) समस्यांबद्दल काळजी करण्याची गरज नाही.

पायथनमध्ये हे [*व्हर्च्युअल एन्व्हायर्नमेंट्स*](https://docs.python.org/3/tutorial/venv.html) द्वारे केले जाते, जे सेल्फ-कंटेंड (self-contained) डिरेक्टरी ट्रीज (directory trees) आहेत ज्यात प्रत्येक डिरेक्टरीमध्ये एका विशिष्ट पायथन आवृत्तीसोबतच ॲप्लिकेशनला आवश्यक असलेली सर्व पॅकेजेस इन्स्टॉल केलेली असतात. असे व्हर्च्युअल एन्व्हायर्नमेंट तयार करणे अनेक वेगवेगळ्या टूल्सद्वारे केले जाऊ शकते, परंतु आपण त्या हेतूसाठी अधिकृत पायथन पॅकेज वापरू, ज्याला [`venv`](https://docs.python.org/3/library/venv.html#module-venv) म्हटले जाते.

प्रथम, तुम्हाला तुमचे ॲप्लिकेशन ज्या डिरेक्टरीमध्ये ठेवायचे आहे ती डिरेक्टरी तयार करा — उदाहरणार्थ, तुम्हाला तुमच्या होम डिरेक्टरीच्या रूटमध्ये *transformers-course* नावाची नवीन डिरेक्टरी तयार करावीशी वाटेल:
या डिरेक्टरीच्या आतून, पायथनचे `venv` मॉड्युल वापरून व्हर्च्युअल एन्व्हायर्नमेंट तयार करा:
आता तुमच्या अन्यथा रिकाम्या असलेल्या फोल्डरमध्ये *.env* नावाची डिरेक्टरी असायला हवी:
```out
. .. .env
तुम्ही which python कमांड चालवून एन्व्हायर्नमेंट ॲक्टिव्हेट (activate) झाले आहे की नाही याची खात्री करू शकता: जर ते व्हर्च्युअल एन्व्हायर्नमेंटकडे निर्देशित करत असेल, तर तुम्ही ते यशस्वीरीत्या ॲक्टिव्हेट केले आहे!
डिपेंडन्सी इन्स्टॉल करणे[[installing-dependencies]]
गुगल कोलॅब इन्स्टन्सेस वापरण्याच्या मागील विभागाप्रमाणेच, आता तुम्हाला पुढे जाण्यासाठी आवश्यक असलेली पॅकेजेस इन्स्टॉल करावी लागतील. पुन्हा एकदा, तुम्ही pip पॅकेज मॅनेजर वापरून 🤗 ट्रान्सफॉर्मर्सचे डेव्हलपमेंट व्हर्जन इन्स्टॉल करू शकता:
Loading
Loading