Data-Science-For-Beginners/translations/sw/INSTALLATION.md

Mwongozo wa Ufungaji

Mwongozo huu utakusaidia kuandaa mazingira yako ili kufanya kazi na mtaala wa Data Science kwa Kompyuta.

Jedwali la Maudhui

• Mahitaji ya Awali
• Chaguo za Kuanza Haraka
• Ufungaji wa Kwenye Kompyuta
• Thibitisha Ufungaji Wako

Mahitaji ya Awali

Kabla ya kuanza, unapaswa kuwa na:

• Uelewa wa msingi wa mstari wa amri/terminal
• Akaunti ya GitHub (bure)
• Muunganisho wa intaneti thabiti kwa usanidi wa awali

Chaguo za Kuanza Haraka

Chaguo 1: GitHub Codespaces (Inapendekezwa kwa Kompyuta)

Njia rahisi zaidi ya kuanza ni kutumia GitHub Codespaces, ambayo hutoa mazingira kamili ya maendeleo kwenye kivinjari chako.

1. Tembelea repo
2. Bonyeza menyu ya kushuka ya Code
3. Chagua kichupo cha Codespaces
4. Bonyeza Create codespace on main
5. Subiri mazingira yaanze (dakika 2-3)

Mazingira yako sasa yako tayari na utegemezi wote umewekwa!

Chaguo 2: Maendeleo ya Kwenye Kompyuta

Kwa kufanya kazi kwenye kompyuta yako mwenyewe, fuata maelekezo ya kina hapa chini.

Ufungaji wa Kwenye Kompyuta

Hatua ya 1: Weka Git

Git inahitajika ili kunakili repo na kufuatilia mabadiliko yako.

Windows:

• Pakua kutoka git-scm.com
• Endesha kisakinishi na mipangilio ya chaguo-msingi

macOS:

• Weka kupitia Homebrew: brew install git
• Au pakua kutoka 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

Hatua ya 2: Nakili Repo

# Clone the repository
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# Navigate to the directory
cd Data-Science-For-Beginners

Hatua ya 3: Weka Python na Jupyter

Python 3.7 au zaidi inahitajika kwa masomo ya data science.

Windows:

1. Pakua Python kutoka python.org
2. Wakati wa usakinishaji, angalia "Add Python to PATH"
3. Thibitisha usakinishaji:

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

Hatua ya 4: Sanidi Mazingira ya Python

Inapendekezwa kutumia mazingira ya kawaida ili kuweka utegemezi tofauti.

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate

# On macOS/Linux:
source venv/bin/activate

Hatua ya 5: Weka Maktaba za Python

Weka maktaba zinazohitajika za data science:

pip install jupyter pandas numpy matplotlib seaborn scikit-learn

Hatua ya 6: Weka Node.js na npm (Kwa Programu ya Maswali)

Programu ya maswali inahitaji Node.js na npm.

Windows/macOS:

• Pakua kutoka nodejs.org (toleo la LTS linapendekezwa)
• Endesha kisakinishi

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

Hatua ya 7: Weka Utegemezi wa Programu ya Maswali

# Navigate to quiz app directory
cd quiz-app

# Install dependencies
npm install

# Return to root directory
cd ..

Hatua ya 8: Weka Docsify (Hiari)

Kwa ufikiaji wa nje ya mtandao wa nyaraka:

npm install -g docsify-cli

Thibitisha Ufungaji Wako

Jaribu Python na 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

Kivinjari chako kinapaswa kufunguka na kiolesura cha Jupyter. Sasa unaweza kuvinjari faili yoyote ya .ipynb ya somo.

Jaribu Programu ya Maswali

# Navigate to quiz app
cd quiz-app

# Start development server
npm run serve

Programu ya maswali inapaswa kupatikana kwenye http://localhost:8080 (au bandari nyingine ikiwa 8080 imejaa).

Jaribu Seva ya Nyaraka

# From the root directory of the repository
docsify serve

Nyaraka zinapaswa kupatikana kwenye http://localhost:3000.

Kutumia Kontena za Maendeleo za VS Code

Ikiwa una Docker imewekwa, unaweza kutumia Kontena za Maendeleo za VS Code:

1. Weka Docker Desktop
2. Weka Visual Studio Code
3. Weka kiendelezi cha Remote - Containers
4. Fungua repo kwenye VS Code
5. Bonyeza F1 na uchague "Remote-Containers: Reopen in Container"
6. Subiri kontena lijengwe (mara ya kwanza tu)

Hatua Zifuatazo

• Chunguza README.md kwa muhtasari wa mtaala
• Soma USAGE.md kwa mifumo ya kazi ya kawaida na mifano
• Angalia TROUBLESHOOTING.md ikiwa unakutana na matatizo
• Kagua CONTRIBUTING.md ikiwa unataka kuchangia

Kupata Msaada

Ikiwa unakutana na matatizo:

1. Angalia mwongozo wa TROUBLESHOOTING.md
2. Tafuta Masuala ya GitHub yaliyopo
3. Jiunge na Jamii ya Discord
4. Unda suala jipya na maelezo ya kina kuhusu tatizo lako

---

Kanusho:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.