13 KiB
ఇన్స్టాలేషన్ గైడ్
ఈ గైడ్ మీకు Data Science for Beginners పాఠ్యాంశంతో పని చేయడానికి మీ వాతావరణాన్ని సెట్ చేయడంలో సహాయపడుతుంది.
విషయ సూచిక
ముందస్తు అవసరాలు
మీరు ప్రారంభించడానికి ముందు, మీ వద్ద ఉండాలి:
- కమాండ్ లైన్/టెర్మినల్తో ప్రాథమిక పరిచయం
- GitHub ఖాతా (ఉచితం)
- ప్రారంభ సెటప్ కోసం స్థిరమైన ఇంటర్నెట్ కనెక్షన్
త్వరిత ప్రారంభ ఎంపికలు
ఎంపిక 1: GitHub Codespaces (ఆరంభకులకు సిఫార్సు)
GitHub Codespaces తో ప్రారంభించడం అత్యంత సులభం, ఇది మీ బ్రౌజర్లో పూర్తి అభివృద్ధి వాతావరణాన్ని అందిస్తుంది.
- repository కి వెళ్లండి
- Code డ్రాప్డౌన్ మెనూను క్లిక్ చేయండి
- Codespaces ట్యాబ్ను ఎంచుకోండి
- Create codespace on main క్లిక్ చేయండి
- వాతావరణం ప్రారంభం కావడానికి వేచి ఉండండి (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:
- python.org నుండి Python డౌన్లోడ్ చేసుకోండి
- ఇన్స్టాలేషన్ సమయంలో, "Add Python to PATH" ను గుర్తించండి
- ఇన్స్టాలేషన్ను ధృవీకరించండి:
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 ఉపయోగించవచ్చు:
- 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 community లో చేరండి
- మీ సమస్య గురించి వివరాలతో కొత్త ఇష్యూ సృష్టించండి
అస్పష్టత:
ఈ పత్రాన్ని AI అనువాద సేవ Co-op Translator ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం దాని స్వదేశీ భాషలోనే అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారుల కోసం మేము బాధ్యత వహించము.