11 KiB
ইনস্টলেশন গাইড
এই গাইডটি আপনাকে Data Science for Beginners কারিকুলামের জন্য আপনার পরিবেশ সেট আপ করতে সাহায্য করবে।
সূচিপত্র
প্রয়োজনীয়তা
শুরু করার আগে আপনার যা থাকা উচিত:
- কমান্ড লাইন/টার্মিনালের সাথে মৌলিক পরিচিতি
- একটি GitHub অ্যাকাউন্ট (ফ্রি)
- প্রাথমিক সেটআপের জন্য স্থিতিশীল ইন্টারনেট সংযোগ
দ্রুত শুরু করার বিকল্প
বিকল্প ১: GitHub Codespaces (শুরুকারীদের জন্য সুপারিশকৃত)
শুরু করার সবচেয়ে সহজ উপায় হল GitHub Codespaces ব্যবহার করা, যা আপনার ব্রাউজারে একটি সম্পূর্ণ ডেভেলপমেন্ট পরিবেশ প্রদান করে।
- রিপোজিটরি এ যান
- Code ড্রপডাউন মেনুতে ক্লিক করুন
- Codespaces ট্যাব নির্বাচন করুন
- Create codespace on main এ ক্লিক করুন
- পরিবেশটি ইনিশিয়ালাইজ হওয়ার জন্য অপেক্ষা করুন (২-৩ মিনিট)
আপনার পরিবেশ এখন সমস্ত ডিপেনডেন্সি প্রি-ইনস্টলড অবস্থায় প্রস্তুত!
বিকল্প ২: লোকাল ডেভেলপমেন্ট
আপনার নিজের কম্পিউটারে কাজ করার জন্য নিচের বিস্তারিত নির্দেশনা অনুসরণ করুন।
লোকাল ইনস্টলেশন
ধাপ ১: Git ইনস্টল করুন
রিপোজিটরি ক্লোন করতে এবং আপনার পরিবর্তনগুলি ট্র্যাক করতে Git প্রয়োজন।
Windows:
- git-scm.com থেকে ডাউনলোড করুন
- ডিফল্ট সেটিংস দিয়ে ইনস্টলার চালান
macOS:
- Homebrew ব্যবহার করে ইনস্টল করুন:
brew install git - অথবা git-scm.com থেকে ডাউনলোড করুন
Linux:
# Debian/Ubuntu
sudo apt-get update
sudo apt-get install git
# Fedora
sudo dnf install git
# Arch
sudo pacman -S git
ধাপ ২: রিপোজিটরি ক্লোন করুন
# Clone the repository
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
# Navigate to the directory
cd Data-Science-For-Beginners
ধাপ ৩: Python এবং Jupyter ইনস্টল করুন
ডেটা সায়েন্স লেসনের জন্য Python 3.7 বা তার বেশি প্রয়োজন।
Windows:
- python.org থেকে Python ডাউনলোড করুন
- ইনস্টলেশনের সময় "Add Python to PATH" চেক করুন
- ইনস্টলেশন যাচাই করুন:
python --version
macOS:
# Using Homebrew
brew install python3
# Verify installation
python3 --version
Linux:
# Most Linux distributions come with Python pre-installed
python3 --version
# If not installed:
# Debian/Ubuntu
sudo apt-get install python3 python3-pip
# Fedora
sudo dnf install python3 python3-pip
ধাপ ৪: Python পরিবেশ সেট আপ করুন
ডিপেনডেন্সিগুলি আলাদা রাখতে ভার্চুয়াল পরিবেশ ব্যবহার করার সুপারিশ করা হয়।
# Create a virtual environment
python -m venv venv
# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate
ধাপ ৫: Python প্যাকেজ ইনস্টল করুন
প্রয়োজনীয় ডেটা সায়েন্স লাইব্রেরিগুলি ইনস্টল করুন:
pip install jupyter pandas numpy matplotlib seaborn scikit-learn
ধাপ ৬: Node.js এবং npm ইনস্টল করুন (কুইজ অ্যাপের জন্য)
কুইজ অ্যাপ্লিকেশনের জন্য Node.js এবং npm প্রয়োজন।
Windows/macOS:
- nodejs.org থেকে ডাউনলোড করুন (LTS সংস্করণ সুপারিশকৃত)
- ইনস্টলার চালান
Linux:
# Debian/Ubuntu
# WARNING: Piping scripts from the internet directly into bash can be a security risk.
# It is recommended to review the script before running it:
# curl -fsSL https://deb.nodesource.com/setup_lts.x -o setup_lts.x
# less setup_lts.x
# Then run:
# sudo -E bash setup_lts.x
#
# Alternatively, you can use the one-liner below at your own risk:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# Fedora
sudo dnf install nodejs
# Verify installation
node --version
npm --version
ধাপ ৭: কুইজ অ্যাপ ডিপেনডেন্সি ইনস্টল করুন
# Navigate to quiz app directory
cd quiz-app
# Install dependencies
npm install
# Return to root directory
cd ..
ধাপ ৮: Docsify ইনস্টল করুন (ঐচ্ছিক)
ডকুমেন্টেশনের অফলাইন অ্যাক্সেসের জন্য:
npm install -g docsify-cli
আপনার ইনস্টলেশন যাচাই করুন
Python এবং Jupyter পরীক্ষা করুন
# Activate your virtual environment if not already activated
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate
# Start Jupyter Notebook
jupyter notebook
আপনার ব্রাউজারটি Jupyter ইন্টারফেস সহ খুলবে। এখন আপনি যেকোনো লেসনের .ipynb ফাইল নেভিগেট করতে পারেন।
কুইজ অ্যাপ্লিকেশন পরীক্ষা করুন
# Navigate to quiz app
cd quiz-app
# Start development server
npm run serve
কুইজ অ্যাপটি http://localhost:8080 (অথবা যদি 8080 ব্যস্ত থাকে তবে অন্য পোর্টে) উপলব্ধ হওয়া উচিত।
ডকুমেন্টেশন সার্ভার পরীক্ষা করুন
# From the root directory of the repository
docsify serve
ডকুমেন্টেশনটি http://localhost:3000 এ উপলব্ধ হওয়া উচিত।
VS Code Dev Containers ব্যবহার করা
যদি আপনার Docker ইনস্টল করা থাকে, আপনি VS Code Dev Containers ব্যবহার করতে পারেন:
- Docker Desktop ইনস্টল করুন
- Visual Studio Code ইনস্টল করুন
- Remote - Containers extension ইনস্টল করুন
- রিপোজিটরি VS Code-এ খুলুন
F1চাপুন এবং "Remote-Containers: Reopen in Container" নির্বাচন করুন- কন্টেইনারটি তৈরি হওয়ার জন্য অপেক্ষা করুন (শুধুমাত্র প্রথমবার)
পরবর্তী পদক্ষেপ
- কারিকুলামের ওভারভিউয়ের জন্য README.md অন্বেষণ করুন
- সাধারণ ওয়ার্কফ্লো এবং উদাহরণের জন্য USAGE.md পড়ুন
- যদি কোনো সমস্যা হয় তবে TROUBLESHOOTING.md পরীক্ষা করুন
- অবদান রাখতে চাইলে CONTRIBUTING.md পর্যালোচনা করুন
সাহায্য পাওয়া
যদি কোনো সমস্যা হয়:
- TROUBLESHOOTING.md গাইড পরীক্ষা করুন
- বিদ্যমান GitHub Issues অনুসন্ধান করুন
- আমাদের Discord কমিউনিটি এ যোগ দিন
- আপনার সমস্যার বিস্তারিত তথ্য সহ একটি নতুন ইস্যু তৈরি করুন
অস্বীকৃতি:
এই নথিটি AI অনুবাদ পরিষেবা Co-op Translator ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতা নিশ্চিত করার চেষ্টা করি, তবে অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল ভাষায় থাকা নথিটিকে প্রামাণিক উৎস হিসেবে বিবেচনা করা উচিত। গুরুত্বপূর্ণ তথ্যের জন্য, পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদ ব্যবহারের ফলে কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যা হলে আমরা দায়বদ্ধ থাকব না।