Skip to content

INSTALLATION.md

Latest commit

 

History

History
254 lines (179 loc) · 13.2 KB

INSTALLATION.md

File metadata and controls

254 lines (179 loc) · 13.2 KB

ఇన్‌స్టాలేషన్ గైడ్

ఈ గైడ్ మీకు Data Science for Beginners పాఠ్యాంశంతో పని చేయడానికి మీ వాతావరణాన్ని సెట్ చేయడంలో సహాయపడుతుంది.

విషయ సూచిక

ముందస్తు అవసరాలు

మీరు ప్రారంభించడానికి ముందు, మీ వద్ద ఉండాలి:

  • కమాండ్ లైన్/టెర్మినల్‌తో ప్రాథమిక పరిచయం
  • GitHub ఖాతా (ఉచితం)
  • ప్రారంభ సెటప్ కోసం స్థిరమైన ఇంటర్నెట్ కనెక్షన్

త్వరిత ప్రారంభ ఎంపికలు

ఎంపిక 1: GitHub Codespaces (ఆరంభకులకు సిఫార్సు)

GitHub Codespaces తో ప్రారంభించడం అత్యంత సులభం, ఇది మీ బ్రౌజర్‌లో పూర్తి అభివృద్ధి వాతావరణాన్ని అందిస్తుంది.

  1. repository కి వెళ్లండి
  2. Code డ్రాప్‌డౌన్ మెనూను క్లిక్ చేయండి
  3. Codespaces ట్యాబ్‌ను ఎంచుకోండి
  4. Create codespace on main క్లిక్ చేయండి
  5. వాతావరణం ప్రారంభం కావడానికి వేచి ఉండండి (2-3 నిమిషాలు)

మీ వాతావరణం ఇప్పుడు అన్ని డిపెండెన్సీలతో ముందుగా ఇన్‌స్టాల్ చేయబడింది!

ఎంపిక 2: స్థానిక అభివృద్ధి

మీ స్వంత కంప్యూటర్‌లో పని చేయడానికి, క్రింది వివరమైన సూచనలను అనుసరించండి.

స్థానిక ఇన్‌స్టాలేషన్

దశ 1: Git ఇన్‌స్టాల్ చేయండి

Git రిపాజిటరీని క్లోన్ చేయడానికి మరియు మీ మార్పులను ట్రాక్ చేయడానికి అవసరం.

Windows:

  • git-scm.com నుండి డౌన్లోడ్ చేసుకోండి
  • డిఫాల్ట్ సెట్టింగ్స్‌తో ఇన్‌స్టాలర్‌ను రన్ చేయండి

macOS:

  • Homebrew ద్వారా ఇన్‌స్టాల్ చేయండి: brew install git
  • లేదా git-scm.com నుండి డౌన్లోడ్ చేసుకోండి

Linux:

# డెబియన్/ఉబుంటు
sudo apt-get update
sudo apt-get install git

# ఫెడోరా
sudo dnf install git

# ఆర్చ్
sudo pacman -S git

దశ 2: రిపాజిటరీని క్లోన్ చేయండి

# రిపోజిటరీని క్లోన్ చేయండి
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# డైరెక్టరీకి నావిగేట్ చేయండి
cd Data-Science-For-Beginners

దశ 3: Python మరియు Jupyter ఇన్‌స్టాల్ చేయండి

Python 3.7 లేదా అంతకంటే పై వెర్షన్ డేటా సైన్స్ పాఠాల కోసం అవసరం.

Windows:

  1. python.org నుండి Python డౌన్లోడ్ చేసుకోండి
  2. ఇన్‌స్టాలేషన్ సమయంలో, "Add Python to PATH" ను గుర్తించండి
  3. ఇన్‌స్టాలేషన్‌ను ధృవీకరించండి:
python --version

macOS:

# హోంబ్రూ ఉపయోగించడం
brew install python3

# ఇన్‌స్టాలేషన్‌ను ధృవీకరించండి
python3 --version

Linux:

# ఎక్కువ Linux పంపిణీలు Python ముందుగా ఇన్‌స్టాల్ చేయబడినవిగా వస్తాయి
python3 --version

# ఇన్‌స్టాల్ చేయబడకపోతే:
# Debian/Ubuntu
sudo apt-get install python3 python3-pip

# Fedora
sudo dnf install python3 python3-pip

దశ 4: Python వాతావరణాన్ని సెట్ చేయండి

డిపెండెన్సీలను వేరుగా ఉంచడానికి వర్చువల్ వాతావరణం ఉపయోగించడం సిఫార్సు చేయబడింది.

# ఒక వర్చువల్ ఎన్విరాన్‌మెంట్ సృష్టించండి
python -m venv venv

# వర్చువల్ ఎన్విరాన్‌మెంట్‌ను యాక్టివేట్ చేయండి
# విండోస్‌లో:
venv\Scripts\activate

# మాక్‌ఓఎస్/లినక్స్‌లో:
source venv/bin/activate

దశ 5: Python ప్యాకేజీలను ఇన్‌స్టాల్ చేయండి

అవసరమైన డేటా సైన్స్ లైబ్రరీలను ఇన్‌స్టాల్ చేయండి:

pip install jupyter pandas numpy matplotlib seaborn scikit-learn

దశ 6: Node.js మరియు npm ఇన్‌స్టాల్ చేయండి (Quiz App కోసం)

క్విజ్ అప్లికేషన్‌కు Node.js మరియు npm అవసరం.

Windows/macOS:

  • nodejs.org నుండి డౌన్లోడ్ చేసుకోండి (LTS వెర్షన్ సిఫార్సు)
  • ఇన్‌స్టాలర్‌ను రన్ చేయండి

Linux:

# డెబియన్/ఉబుంటు
# హెచ్చరిక: ఇంటర్నెట్ నుండి స్క్రిప్టులను నేరుగా బాష్‌లో పైప్ చేయడం భద్రతా ప్రమాదం కావచ్చు.
# స్క్రిప్ట్‌ను నడపడానికి ముందు సమీక్షించడం సిఫార్సు చేయబడింది:
#   curl -fsSL https://deb.nodesource.com/setup_lts.x -o setup_lts.x
#   less setup_lts.x
# ఆపై నడపండి:
#   sudo -E bash setup_lts.x
#
# ప్రత్యామ్నాయంగా, మీ స్వంత ప్రమాదంలో క్రింది ఒక లైనర్‌ను ఉపయోగించవచ్చు:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# ఫెడోరా
sudo dnf install nodejs

# ఇన్‌స్టాలేషన్‌ను ధృవీకరించండి
node --version
npm --version

దశ 7: Quiz App డిపెండెన్సీలను ఇన్‌స్టాల్ చేయండి

# క్విజ్ యాప్ డైరెక్టరీకి నావిగేట్ చేయండి
cd quiz-app

# డిపెండెన్సీలను ఇన్‌స్టాల్ చేయండి
npm install

# రూట్ డైరెక్టరీకి తిరిగి వెళ్లండి
cd ..

దశ 8: Docsify ఇన్‌స్టాల్ చేయండి (ఐచ్ఛికం)

డాక్యుమెంటేషన్‌ను ఆఫ్‌లైన్ యాక్సెస్ కోసం:

npm install -g docsify-cli

మీ ఇన్‌స్టాలేషన్‌ను ధృవీకరించండి

Python మరియు Jupyter ను పరీక్షించండి

# మీ వర్చువల్ ఎన్విరాన్‌మెంట్ ఇప్పటికే యాక్టివేట్ కాకపోతే యాక్టివేట్ చేయండి
# విండోస్‌లో:
venv\Scripts\activate
# మాక్‌ఓఎస్/లినక్స్‌లో:
source venv/bin/activate

# జూపిటర్ నోట్‌బుక్ ప్రారంభించండి
jupyter notebook

మీ బ్రౌజర్ Jupyter ఇంటర్‌ఫేస్‌తో తెరవాలి. మీరు ఇప్పుడు ఏ పాఠం .ipynb ఫైల్‌కు వెళ్లవచ్చు.

Quiz అప్లికేషన్‌ను పరీక్షించండి

# క్విజ్ యాప్‌కు నావిగేట్ చేయండి
cd quiz-app

# అభివృద్ధి సర్వర్‌ను ప్రారంభించండి
npm run serve

క్విజ్ యాప్ http://localhost:8080 (లేదా 8080 బిజీ అయితే మరొక పోర్ట్) వద్ద అందుబాటులో ఉండాలి.

డాక్యుమెంటేషన్ సర్వర్‌ను పరీక్షించండి

# రిపాజిటరీ యొక్క రూట్ డైరెక్టరీ నుండి
docsify serve

డాక్యుమెంటేషన్ http://localhost:3000 వద్ద అందుబాటులో ఉండాలి.

VS Code Dev Containers ఉపయోగించడం

మీ వద్ద Docker ఇన్‌స్టాల్ ఉంటే, మీరు VS Code Dev Containers ఉపయోగించవచ్చు:

  1. Docker Desktop ఇన్‌స్టాల్ చేయండి
  2. Visual Studio Code ఇన్‌స్టాల్ చేయండి
  3. Remote - Containers extension ఇన్‌స్టాల్ చేయండి
  4. రిపాజిటరీని VS Code లో ఓపెన్ చేయండి
  5. F1 నొక్కి "Remote-Containers: Reopen in Container" ఎంచుకోండి
  6. కంటైనర్ నిర్మాణం కోసం వేచి ఉండండి (మొదటి సారి మాత్రమే)

తదుపరి దశలు

  • పాఠ్యాంశం అవలోకనం కోసం README.md ను అన్వేషించండి
  • సాధారణ వర్క్‌ఫ్లోలు మరియు ఉదాహరణల కోసం USAGE.md చదవండి
  • సమస్యలు ఎదురైతే TROUBLESHOOTING.md ను తనిఖీ చేయండి
  • మీరు సహకరించాలనుకుంటే CONTRIBUTING.md ను సమీక్షించండి

సహాయం పొందడం

మీరు సమస్యలను ఎదుర్కొంటే:

  1. TROUBLESHOOTING.md గైడ్‌ను తనిఖీ చేయండి
  2. ఉన్న GitHub Issues ను శోధించండి
  3. మా Discord community లో చేరండి
  4. మీ సమస్య గురించి వివరాలతో కొత్త ఇష్యూ సృష్టించండి

అస్పష్టత:
ఈ పత్రాన్ని AI అనువాద సేవ Co-op Translator ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం దాని స్వదేశీ భాషలోనే అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారుల కోసం మేము బాధ్యత వహించము.