PhiCookBook / kn

# AGENTS.md

## Project Overview

PhiCookBook ಮೈಸೂರುಗಳ Microsoft Phi ಕುಟುಂಬದ ಸಣ್ಣ ಭಾಷಾ ಮಾದರಿಗಳ (SLMs)ೊಂದಿಗೆ ಕೆಲಸ ಮಾಡಲು ಕೈಗೊಳ್ಳುವ ಉದಾಹರಣೆಗಳು, ಪಾಠಗಳು ಮತ್ತು ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಅನ್ನು ಒಳಗೊಂಡ ಸಮಗ್ರ ಕುಕ್‌ಬುಕ್ ಸಂಗ್ರಹವಾಗಿದೆ. ಈ ಸಂಗ್ರಹವು ಇನ್ಫರೆನ್ಸ್, ಫೈನ್-ಟ್ಯೂನಿಂಗ್, ಕ್ವಾಂಟೈಜೇಶನ್, RAG ಅನುಷ್ಠಾನಗಳು ಮತ್ತು ಬಹುಮಾಧ್ಯಮ ಅಪ್ಲಿಕೇಶನ್ಗಳನ್ನು ವಿವಿಧ ವೇದಿಕೆಗಳು ಮತ್ತು ಫ್ರೇಂವರ್ಕ್‌ಗಳ ಮೇಲೆ ಪ್ರದರ್ಶಿಸುತ್ತದೆ.

**ಪ್ರಮುಖ ತಂತ್ರಜ್ಞಾನಗಳು:**
- **ಭಾಷೆಗಳು:** Python, C#/.NET, JavaScript/Node.js
- **ಫ್ರೇಂವರ್ಕ್‌ಗಳು:** ONNX Runtime, PyTorch, Transformers, MLX, OpenVINO, Semantic Kernel
- **ವೇದಿಕೆಗಳು:** Microsoft Foundry, GitHub Models, Hugging Face, Ollama
- **ಮಾದರಿ ಪ್ರಕಾರಗಳು:** Phi-3, Phi-3.5, Phi-4 (ಪಠ್ಯ, ದೃಷ್ಟಿ, ಬಹೂಮಾಧ್ಯಮ, ನಿರ್ಣಯಾತ್ಮಕ ರೂಪಾಂತರಗಳು)

**ಸಂಗ್ರಹ ರಚನೆ:**
- `/code/` - ಕೆಲಸದ ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಮತ್ತು ಮಾದರಿ ಅನುಷ್ಠಾನಗಳು
- `/md/` - ವಿವರವಾದ ಡಾಕ್ಯುಮೆಂಟೇಶನ್, ಪಾಠಗಳು ಮತ್ತು ಹೇಗೆ ಮಾಡುವುದು ಮಾರ್ಗದರ್ಶನಗಳು  
- `/translations/` - ಬಹುಭಾಷಾ ಅನುವಾದಗಳು (50+ ಭಾಷೆಗಳು ಸ್ವಯಂಚಾಲಿತ ಕಾರ್ಯಪ್ರವಾಹದ ಮೂಲಕ)
- `/.devcontainer/` - ಡೇವ್ ಕಂಟೈನರ್ ಸಂರಚನೆ (Python 3.12 Ollama ಜೊತೆಗೆ)

## Development Environment Setup

### GitHub Codespaces ಅಥವಾ ಡೇವ್ ಕಂಟೈನರ್‌ಗಳನ್ನು ಬಳಸಿ (ಶಿಫಾರಸು)

1. GitHub Codespaces ನಲ್ಲಿ ತೆರೆಯಿರಿ (ಎಲ್ಲಾದ ಯಶಸ್ವಿಯಾಗಿ):
   - README ನಲ್ಲಿ "Open in GitHub Codespaces" ಬ್ಯಾಡ್ಜ್ ಕ್ಲಿಕ್ ಮಾಡಿ
   - ಕಂಟೈನರ್ ಸ್ವಯಂಚಾಲಿತವಾಗಿ Python 3.12 ಮತ್ತು Phi-3 ಜೊತೆ Ollama ಸೆಟ್ಟಪ್ ಆಗುತ್ತದೆ

2. VS Code ಡೇವ್ ಕಂಟೈನರ್‌ಗಳಲ್ಲಿ ತೆರೆಯಿರಿ:
   - README ನಲ್ಲಿ "Open in Dev Containers" ಬ್ಯಾಡ್ಜ್ ಬಳಸಿ
   - ಕಂಟೈನರ್‌ಗೆ ಕನಿಷ್ಠ 16GB ಆತಿಥ್ಯ ಮ emmory ಅಗತ್ಯವಿದೆ

### ಸ್ಥಳೀಯ ಸೆಟ್‌ಅಪ್

**ಅಗತ್ಯತೆಗಳು:**
- Python 3.12 ಅಥವಾ ನಂತರದ ಆವೃತ್ತಿ
- .NET 8.0 SDK (C# ಉದಾಹರಣೆಗಳಿಗೆ)
- Node.js 18+ ಮತ್ತು npm (JavaScript ಉದಾಹರಣೆಗೆ)
- ಕನಿಷ್ಠ 16GB RAM ಶಿಫಾರಸು

**ಸ್ಥಾಪನೆ:**
```bash
git clone https://github.com/microsoft/PhiCookBook.git
cd PhiCookBook
```

**Python ಉದಾಹರಣೆಗಳಿಗಾಗಿ:**
ನಿರ್ದಿಷ್ಟ ಉದಾಹರಣಾ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ತೆರಳಿ ಅವಲಂಬನೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ:
```bash
cd code/<example-directory>
pip install -r requirements.txt  # requirements.txt ಇದ್ದರೆ
```

**.NET ಉದಾಹರಣೆಗಳಿಗಾಗಿ:**
```bash
cd md/04.HOL/dotnet/src
dotnet restore LabsPhi.sln
dotnet build LabsPhi.sln
```

**JavaScript/Web ಉದಾಹರಣೆಗಳಿಗಾಗಿ:**
```bash
cd code/08.RAG/rag_webgpu_chat
npm install
npm run dev  # ಅಭಿವೃದ್ಧಿ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run build  # ಉತ್ಪಾದನೆಗಾಗಿ ನಿರ್ಮಿಸಿ
```

## Repository Organization

### ಕೋಡ್ ಉದಾಹರಣೆಗಳು (`/code/`)

- **01.Introduce/** - ಮೂಲಭೂತ ಪರಿಚಯಗಳು ಮತ್ತು ಪ್ರಾರಂಭಿಕ ಮಾದರಿಗಳು
- **03.Finetuning/** ಮತ್ತು **04.Finetuning/** - ವಿಭಿನ್ನ ವಿಧಾನಗಳೊಂದಿಗೆ ಫೈನ್-ಟ್ಯೂನಿಂಗ್ ಉದಾಹರಣೆಗಳು
- **03.Inference/** - ವಿಭಿನ್ನ ಹಾರ್ಡ್‌ವೇರ್‌ಗಳ (AIPC, MLX) ಮೇಲೆ ಇನ್ಫರೆನ್ಸ್ ಉದಾಹರಣೆಗಳು
- **06.E2E/** - ಸಂಪೂರ್ಣ ಅಪ್ಲಿಕೇಶನ್ ಮಾದರಿಗಳು
- **07.Lab/** - ಪ್ರಯೋಗಶಾಲೆ/ಪ್ರಾಯೋಗಿಕ ಅನುಷ್ಠಾನಗಳು
- **08.RAG/** - ರಿಟ್ರೀವಲ್-ಆಗ್ಮೆಂಟೆಡ್ ಜನರೇಶನ್ ಮಾದರಿಗಳು
- **09.UpdateSamples/** - ಇತ್ತೀಚಿನ ನವೀಕರಿಸಿದ ಮಾದರಿಗಳು

### ಡಾಕ್ಯುಮೆಂಟೇಶನ್ (`/md/`)

- **01.Introduction/** - ಪರಿಚಯ ಮಾರ್ಗದರ್ಶಿಗಳು, ಪರಿಸರ ಸೆಟ್‌ಅಪ್, ವೇದಿಕೆ ಮಾರ್ಗದರ್ಶನಗಳು
- **02.Application/** - ವಿಧಾನದ ಪ್ರಕಾರ ಜೋಡಿಸಲಾದ ಅಪ್ಲಿಕೇಶನ್ ಮಾದರಿಗಳು (ಪಠ್ಯ, ಕೋಡ್, ದೃಷ್ಟಿ, ಧ್ವನಿ, ಇತ್ಯಾದಿ)
- **02.QuickStart/** - Microsoft Foundry ಮತ್ತು GitHub Models ನ ವೇಗದ ಪ್ರಾರಂಭ ಮಾರ್ಗದರ್ಶನಗಳು
- **03.FineTuning/** - ಫೈನ್-ಟ್ಯೂನಿಂಗ್ ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಮತ್ತು ಪಾಠಗಳು
- **04.HOL/** - ಕೈಬಿಡುವ ಪ್ರಯೋಗಾಲಯಗಳು (.NET ಉದಾಹರಣೆಗಳೊಂದಿಗೆ)

### ಕಡತ ರೂಪಗಳು

- **Jupyter ನೋಟ್ಬುಕ್‌ಗಳು (`.ipynb`)** - README ನಲ್ಲಿ 📓 ಚಿಹ್ನೆ ಇರುವ ಇಂಟರಾಕ್ಟಿವ್ Python ಪಾಠಗಳು
- **Python ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳು (`.py`)** - ಸ್ವತಂತ್ರ Python ಉದಾಹರಣೆಗಳು
- **C# ಪ್ರಾಜೆಕ್ಟ್ಗಳು (`.csproj`, `.sln`)** - .NET ಆ್ಯಪ್ಲಿಕೇಶನ್‌ಗಳು ಮತ್ತು ಮಾದರಿಗಳು
- **JavaScript (`.js`, `package.json`)** - ವೆಬ್ ಮತ್ತು Node.js ಉದಾಹರಣೆಗಳು
- **Markdown (`.md`)** - ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಮತ್ತು ಮಾರ್ಗದರ್ಶನಗಳು

## ಮಾದರಿಗಳೊಂದಿಗೆ ಕೆಲಸ

### Jupyter ನೋಟ್ಬುಕ್‌ಗಳನ್ನು ನಡೆಸುವುದು

ಬಹುತೇಕ ಉದಾಹರಣೆಗಳು Jupyter ನೋಟ್ಬುಕ್‌ಗಳಾಗಿ ನೀಡಲ್ಪಟ್ಟಿವೆ:
```bash
pip install jupyter notebook
jupyter notebook  # ಬ್ರೌಸರ್ ಇಂಟರ್ಫೇಸ್ ತೆರೆಯುತ್ತದೆ
# ಬೇಕಾದ .ipynb ಕಡತಕ್ಕೆ ನ್ಯಾವಿಗೇಟ್ ಮಾಡಿ
```

### Python ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳನ್ನು ನಡೆಸುವುದು

```bash
cd code/<example-directory>
pip install -r requirements.txt
python <script-name>.py
```

### .NET ಉದಾಹರಣೆಗಳನ್ನು ನಡೆಸುವುದು

```bash
cd md/04.HOL/dotnet/src/<project-name>
dotnet run
```

ಅಥವಾ ಸಂಪೂರ್ಣ ಪರಿಹಾರವನ್ನು ನಿರ್ಮಿಸಿ:
```bash
cd md/04.HOL/dotnet/src
dotnet run --project <project-name>
```

### JavaScript/Web ಉದಾಹರಣೆಗಳನ್ನು ನಡೆಸುವುದು

```bash
cd code/08.RAG/rag_webgpu_chat
npm install
npm run dev  # ಹಾಟ್ ರಿಲೋಡ್‌ನೊಂದಿಗೆ ಅಭಿವೃದ್ಧಿ
```

## ಪರೀಕ್ಷೆ

ಈ ಸಂಗ್ರಹವು ಪರಂಪರাগত ಸಾಫ್ಟ್‌ವೇರ್ ಪ್ರಾಜೆಕ್ಟ್ ಜೊತೆಗೆ ಯೂನಿಟ್ ಟೆಸ್ಟ್‌ಗಳನ್ನು ಒಳಗೊಂಡಿದ್ದಿಲ್ಲ, ಬದಲಿಗೆ ಉದಾಹರಣೆ ಕೋಡ್ ಮತ್ತು ಪಾಠಗಳನ್ನು ಹೊಂದಿದೆ. ಮಾನ್ಯತೆಯನ್ನು ಸಾಮಾನ್ಯವಾಗಿ ಕೆಳಗಿನಂತೆ ಮಾಡಲಾಗುತ್ತದೆ:

1. **ಉದಾಹರಣೆಗಳನ್ನು ಚಾಲನೆಯಲ್ಲಿಡು** - ಪ್ರತಿ ಉದಾಹರಣೆ ದೋಷರಹಿತವಾಗಿ ಕಾರ್ಯನಿರ್ವಹಿಸಬೇಕು
2. **ಫಲಿತಾಂಶಗಳನ್ನು ಪರಿಶೀಲಿಸು** - ಮಾದರಿ ಪ್ರತಿಕ್ರಿಯೆಗಳು ಸೂಕ್ತವಾಗಿರಬೇಕು
3. **ಪಾಠಗಳ ಅನುಸರಣೆ** - ಹಂತಗಳ ಮೂಲಕ ಮಾರ್ಗದರ್ಶಿಗಳು ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಪ್ರಕಾರ ಕೆಲಸ ಮಾಡಬೇಕು

**ಸಾಮಾನ್ಯ ಮಾನ್ಯತೆ ವಿಧಾನ:**
- ಗುರಿ ಪರಿಸರದಲ್ಲಿ ಉದಾಹರಣೆಯ ಕಾರ್ಯಾಚರಣೆ ಪರೀಕ್ಷೆ
- ಅವಲಂಬನೆಗಳ ಸರಿಯಾದ ಸ್ಥಾಪನೆ ಪರಿಶೀಲನೆ
- ಮಾದರಿ ಡೌನ್‌ಲೋಡ್/ಲೋಡ್ ಯಶಸ್ವಿಯಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲನೆ
- ನಿರೀಕ್ಷಿತ ವರ್ತನೆ ಡಾಕ್ಯುಮೆಂಟೇಶನ್‌ಗೆ ಅನುಗುಣವಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ

## ಕೋಡ್ ಶೈಲಿ ಮತ್ತು ನಿಯಮಗಳು

### ಸಾಮಾನ್ಯ ಮಾರ್ಗದರ್ಶನಗಳು

- ಉದಾಹರಣೆಗಳು ಸ್ಪಷ್ಟ, ಟಿಪ್ಪಣಿಗಳೊಂದಿಗೆ, ಮತ್ತು ಶೈಕ್ಷಣಿಕವಾಗಿರಬೇಕು
- ಭಾಷಾ-ನಿರ್ದಿಷ್ಟ ನಿಯಮಗಳನ್ನು ಅನುಸರಿಸಿ (Pythonಗೆ PEP 8, .NETಗೆ C# ಮಾನಕಗಳು)
- Phi ಮಾದರಿಗಳ ವಿಶಿಷ್ಟ ಸಾಮರ್ಥ್ಯಗಳನ್ನು ಪ್ರದರ್ಶಿಸುವ ಕಾರ್ಯಕ್ರಮಗಳ ಮೇಲೆ ಗಮನ ಕೇಂದ್ರಿಸು
- ಪ್ರಮುಖ ತತ್ವಗಳು ಮತ್ತು ಮಾದರಿ-ನಿರ್ಧಿಷ್ಟ ಪರಿಮಾಣಗಳನ್ನು ವಿವರಿಸುವ ಟಿಪ್ಪಣಿಗಳನ್ನು ಸೇರಿಸಿ

### ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಮಾನದಂಡಗಳು

**URL ರೂಪಾಂತರ:**
- `[text](../../url)` ಸ್ವರೂಪವನ್ನು ಯಾವುದೇ ಹೆಚ್ಚುವರಿ ಖಾಲಿ ಜಾಗವಿಲ್ಲದೆ ಬಳಸಿ
- ಅಪೇಕ್ಷಿತ ಲಿಂಕ್ಗಳು: ಪ್ರಸ್ತುತ ಡೈರೆಕ್ಟರಿಗಾಗಿ `./`, ಪಿತೃ ಡೈರೆಕ್ಟರಿಗಾಗಿ `../` ಬಳಸಿ
- URLಗಳಲ್ಲಿ ದೇಶ-ನಿರ್ದಿಷ್ಟ ಸ್ಥಳೀಯತೆ ಇರುವುದನ್ನು ತಪ್ಪಿಸಿ (`/en-us/`, `/en/` ತ್ಯಜಿಸಿ)

**ಚಿತ್ರಗಳು:**
- ಎಲ್ಲಾ ಚಿತ್ರಗಳನ್ನು `/imgs/` ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ ಸಂಗ್ರಹಿಸಿ
- ಇಂಗ್ಲೀಷ್ ಅಕ್ಷರಗಳು, ಸಂಖ್ಯೆಗಳು ಮತ್ತು ಡ್ಯಾಶ್ ಗಳೊಂದಿಗೆ ವಿವರಣಾತ್ಮಕ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ
- ಉದಾಹರಣೆ: `phi-3-architecture.png`

**Markdown ಫೈಲುಗಳು:**
- ಸಮಯೋಚಿತ ನೈೋಪಾಯಗೊಳ್ಳುವ ಕಾರ್ಯವಾಗಿ `/code/`里的 ಸಕ್ರಿಯ ಉಡುಪುಗಳನ್ನು ಉಲ್ಲೇಖಿಸಿ
- ಕೋಡ್ ಬದಲಾವಣೆಗಳಿಗೆ ಹೊಂದಿಕೊಳ್ಳುವಂತೆ ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ನಿರ್ವಹಿಸಿ
- README ನಲ್ಲಿ Jupyter ನೋಟ್ಬುಕ್ ಲಿಂಕ್ಗಳಿಗೆ 📓 ಚಿಹ್ನೆ ಬಳಸಿ ಗುರುತಿಸಿ

### ಕಡತ ಸಂಘಟನೆ

- `/code/`ನಲ್ಲಿ ವಿಷಯ/ಫೀಚರ್ ಪ್ರಕಾರ ಸಂಗ್ರಹಿತ ಕೋಡ್ ಉದಾಹರಣೆಗಳು
- `/md/`ನಲ್ಲಿ ಸಾಧ್ಯವಾದಷ್ಟು ಕೋಡ್ ರಚನೆಯ ಮಿರರ್ ಆಗಿರುವ ಡಾಕ್ಯುಮೆಂಟೇಶನ್
- ಸಂಬಂಧಿತ ಕಡತಗಳನ್ನು (ನೋಟ್ಬುಕ್‌ಗಳು, ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳು, ಸಂರಚನೆಗಳು) ಉಪ-ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಒಟ್ಟುಗೂಡಿಸಿ

## ಮುಚ್ಚಲಿರುವ ವಿನಂತಿ ಮಾರ್ಗದರ್ಶಿಗಳು

### ಸಲ್ಲಿಸುವ ಮೊದಲು

1. **ಸಂಗ್ರಹವನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ** ನಿಮ್ಮ ಖಾತೆಗೆ
2. **PR ಗಳು ಪ್ರಕಾರಾಂತರಗೊಳ್ಳಬೇಕು:**
   - ದೋಷ ಸಂಶೋಧನೆಗಳು ಒಂದಿಷ್ಟು PR ನಲ್ಲಿ
   - ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ನವೀಕರಣಗಳು ಬೇರೆ PR ನಲ್ಲಿ
   - ಹೊಸ ಉದಾಹರಣೆಗಳು ಪ್ರತ್ಯೇಕ PR ಗಳಲ್ಲಿ
   - ಟೈಪೋ ದೋಷಗಳು ಸಂಯೋಜಿಸಬಹುದು

3. **ಮರ್ಡ್ ಘರ್ಷಣೆಗಳನ್ನು ನಿರ್ವಹಿಸಿ:**
   - ಬದಲಾವಣೆಯ ಮೊದಲು ನಿಮ್ಮ ಸ್ಥಳೀಯ `main` ಶಾಖೆಯನ್ನು ನವೀಕರಿಸಿ
   - ಅಪ್‌ಸ್ಟ್ರೀಮ್‌ನೊಂದಿಗೆ ನಿಯಮಿತವಾಗಿ ಸಮಿಕಾಲೀನ ಮಾಡಿ

4. **ಅನುವಾದ PR ಗಳು:**
   - ಫೋಲ್ಡರ್‌ನಲ್ಲಿ ಎಲ್ಲಾ ಫೈಲ್‌ಗಳ ಅನುವಾದಗಳನ್ನು ಹೊಂದಿರಬೇಕು
   - ಮೂಲ ಭಾಷೆಯ ಸಂರಚನೆಯೊಂದಿಗೆ ಹೊಂದಾಣಿಕೆ ಹೊಂದಿರಬೇಕು

### ಅಗತ್ಯ چೆಕ್‌ಗಳು

PRಗಳು ಸ್ವಯಂಚಾಲಿತವಾಗಿ GitHub ಕಾರ್ಯಪ್ರವಾಹಗಳನ್ನು ಚಾಲನೆ ಮಾಡಿ ಮಾನ್ಯತೆಯನ್ನು ಮರುಪರಿಶೀಲನೆ ಮಾಡುತ್ತವೆ:

1. **ಸಾಪೇಕ್ಷ ಮಾರ್ಗ ಮಾನ್ಯತೆ** - ಎಲ್ಲಾ ಆಂತರಿಕ ಲಿಂಕ್ಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸಬೇಕು
   - ಸ್ಥಳೀಯವಾಗಿลಿಂಕ್ಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ: VS Code ನಲ್ಲಿ Ctrl+Click ಬಳಸಿ
   - VS Code ನಿಂದ ಮಾರ್ಗ ಸಲಹೆಗಳು ಬಳಸಿ (`./` ಅಥವಾ `../`)

2. **URL ಸ್ಥಳೀಯತೆ ಪರಿಶೀಲನೆ** - ವೆಬ್ URL ಗಳು ದೇಶ-ನಿರ್ದಿಷ್ಟ ಸ್ಥಳೀಯತೆ ಹೊಂದಬಾರದು
   - `/en-us/`, `/en/` ಅಥವಾ ಇತರ ಭಾಷಾ ಕೋಡ್‌ಗಳನ್ನು ತೆಗೆದುಹಾಕಿ
   - ಸಾಮಾನ್ಯ ಅಂತರರಾಷ್ಟ್ರೀಯ URL ಗಳು ಬಳಸಿ

3. **ತಪ್ಪಾದ URL ಪರಿಶೀಲನೆ** - ಎಲ್ಲಾ URL ಗಳು 200 ಸ್ಥಿತಿ ಕಳಿಸಲು ಹೊಂದಿರಬೇಕು
   - ಸಲ್ಲಿಸುವ ಮೊದಲು ಲಿಂಕ್ಗಳು ಲಭ್ಯವಿರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ
   - ಕೆಲವೊಮ್ಮೆ ವೈಫೈ ಅಥವಾ ಅಂತರಜಾಲ ನಿರ್ಬಂಧಗಳ ಕಾರಣದಿಂದ ತಪ್ಪಬಹುದು

### PR ಶೀರ್ಷಿಕೆ ಸ್ವರೂಪ

```
[component] Brief description
```

ಉದಾಹರಣೆಗಳು:
- `[docs] Add Phi-4 inference tutorial`
- `[code] Fix ONNX Runtime integration example`
- `[translation] Add Japanese translation for intro guides`

## ಸಾಮಾನ್ಯ ಅಭಿವೃದ್ಧಿ ಮಾದರಿಗಳು

### Phi ಮಾದರಿಗಳೊಂದಿಗೆ ಕೆಲಸ

**ಮಾದರಿ ಲೋಡ್ ಮಾಡುವುದು:**
- ಉದಾಹರಣೆಗಳಲ್ಲಿ ವಿಭಿನ್ನ ಫ್ರೇಂವರ್ಕ್‌ಗಳು ಉಪಯೋಗಿಸಲ್ಪಡುತ್ತವೆ: Transformers, ONNX Runtime, MLX, OpenVINO
- ಮಾದರಿಗಳು ಸಾಮಾನ್ಯವಾಗಿ Hugging Face, Azure, ಅಥವಾ GitHub Models ರಿಂದ ಡೌನ್‌ಲೋಡ್ ಮಾಡಲಾಗುತ್ತವೆ
- ನಿಮ್ಮ ಹಾರ್ಡ್‌ವೇರ್ (CPU, GPU, NPU) ಮಾದರಿಯ ಅನುರೂಪತೆಗೆ ಪರಿಶೀಲನೆ ಮಾಡಿ

**ಇನ್ಫರೆನ್ಸ್ ಮಾದರಿಗಳು:**
- ಪಠ್ಯ ನಿರ್ಮಾಣ: ಹೆಚ್ಚಿನ ಉದಾಹರಣೆಗಳು ಚಾಟ್/ಅನುನಯ ರೂಪಾಂತರಗಳನ್ನು ಬಳಸುತ್ತವೆ
- ದೃಷ್ಟಿ: Phi-3-vision ಮತ್ತು Phi-4-multimodal ಚಿತ್ರ ಅರ್ಥಮಾಡಿಕೊಳ್ಳಲು
- ಧ್ವನಿ: Phi-4-multimodal ಧ್ವನಿ ಇನ್‌ಪುಟ್ ಅನ್ನು ಬೆಂಬಲಿಸುತ್ತದೆ
- ನಿರ್ಣಯಾತ್ಮಕತೆ: Phi-4-reasoning ರೂಪಾಂತರಗಳು ಉನ್ನತ ನಿರ್ಣಯಾತ್ಮಕ ಕಾರ್ಯಗಳಿಗೆ

### ವೇದಿಕೆ-ನಿರ್ದಿಷ್ಟ ಗಮನಿಕೆಗಳು

**Microsoft Foundry:**
- Azure ಸಬ್ಸ್ಕ್ರಿಪ್ಷನ್ ಮತ್ತು API ಕೀಲಿಗಳನ್ನು ಅವಶ್ಯಕತೆ
- ನೋಡಿ `/md/02.QuickStart/AzureAIFoundry_QuickStart.md`

**GitHub Models:**
- ಪರೀಕ್ಷೆಗೆ ಉಚಿತ ಟಿಯರ್ ಲಭ್ಯವಿದೆ
- ನೋಡಿ `/md/02.QuickStart/GitHubModel_QuickStart.md`

**ಸ್ಥಳೀಯ ಇನ್ಫರೆನ್ಸ್:**
- ONNX Runtime: ಕ್ರಾಸ್-ಪ್ಲಾಟ್‌ಫಾರ್ಮ್, ಪರಿಪಾಕವಾದ ಇನ್ಫರೆನ್ಸ್
- Ollama: ಸ್ಥಳೀಯ ಮಾದರಿ ನಿರ್ವಹಣೆ ಸುಲಭ (ಡೇವ್ ಕಂಟೈನರ್‌ನಲ್ಲಿ ಪೂರ್ವ-ಸಂರಚಿತ)
- Apple MLX: ಆಪಲ್ ಸಿಲಿಕಾನ್‌ಗೆ ಪರಿಪಾಕವಾಗಿದ್ದು

## ಸಮಸ್ಯೆ ಪರಿಹಾರ

### ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು

**ಮೆಮರಿ ಸಮಸ್ಯೆಗಳು:**
- Phi ಮಾದರಿಗಳಿಗೆ ಸಾಕಷ್ಟು RAM ಅಗತ್ಯವಿದೆ (ಖ್ಯಾತವಾಗಿ ದೃಷ್ಟಿ/ಬಹುಮಾಧ್ಯಮ ರೂಪಾಂತರಗಳು)
- ಸಂಪನ್ಮೂಲ-ಕಡಿಮೆಯಾದ ಪರಿಸರಗಳಿಗೆ ಕ್ವಾಂಟೈಜ್ಡ್ ಮಾದರಿಗಳನ್ನು ಬಳಸಿ
- ನೋಡಿ `/md/01.Introduction/04/QuantifyingPhi.md`

**ಅವಲಂಬನೆಗಳ ಘರ್ಷಣೆಗಳು:**
- Python ಉದಾಹರಣೆಗಳಿಗೆ ನಿಖರ ಆವೃತ್ತಿ ಅಗತ್ಯವಿರಬಹುದು
- ಪ್ರತಿ ಉದಾಹರಣೆಗೆ ವರ್ಚುಯಲ್ ಪರಿಸರಗಳನ್ನು ಬಳಸಿ
- ವೈಯಕ್ತಿಕ `requirements.txt` ಕಡತಗಳನ್ನು ಪರಿಶೀಲಿಸಿ

**ಮಾದರಿ ಡೌನ್‌ಲೋಡ್ ವಿಫಲತೆಗಳು:**
- ದೊಡ್ಡ ಮಾದರಿಗಳು ನಿಧಾನ ಸಂಪರ್ಕದಲ್ಲಿಯಲ್ಲಿ timeout ಆಗಬಹುದು
- ಮೋಡ ಪರಿಸರಗಳ (Codespaces, Azure) ಬಳಕೆಯನ್ನು ಪರಿಗಣಿಸಿ
- Hugging Face ಕ್ಯಾಶೆ ಪರಿಶೀಲನೆ: `~/.cache/huggingface/`

**.NET ಪ್ರಾಜೆಕ್ಟ್ ಸಮಸ್ಯೆಗಳು:**
- .NET 8.0 SDK ಸ್ಥಾಪಿತವಾಗಿರಬೇಕು
- ನಿರ್ಮಿಸುವ ಮೊದಲು `dotnet restore` ಬಳಸಿ
- ಕೆಲವು ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು CUDA-ನಿರ್ದಿಷ್ಟ ಸಂರಚನೆಗಳನ್ನು ಹೊಂದಿರಬಹುದು (Debug_Cuda)

**JavaScript/Web ಉದಾಹರಣೆಗಳು:**
- Node.js 18+ ಬಳಸಬೇಕು
- ಸಮಸ್ಯೆಗಳಿದ್ದರೆ `node_modules` ತೆರವುಗೊಳಿಸಿ ಪುನಃ ಸ್ಥಾಪನೆ ಮಾಡಿ
- WebGPU ಹೊಂದಾಣಿಕೆ ಸಮಸ್ಯೆಗಾಗಿ ಬ್ರೌಸರ್ ಕন್ಸೋಲ್ ಪರಿಶೀಲಿಸಿ

### ಸಹಾಯ ಪಡೆಯುವುದು

- **Discord:** Microsoft Foundry Community Discord ನಲ್ಲಿ ಸೇರಿ
- **GitHub Issues:** ಬಗ್ಗಿ ಮತ್ತು ಸಮಸ್ಯೆಗಳನ್ನು ವರದಿ ಮಾಡಿ
- **GitHub Discussions:** ಪ್ರಶ್ನೆ ಕೇಳಿ ಮತ್ತು ಜ್ಞಾನ ಹಂಚಿಕೊಳ್ಳಿ

## ಹೆಚ್ಚುವರಿ ಪ್ರಾಸಂಗಿಕತೆ

### ಜವಾಬ್ದಾರಿಯುತ AI

ಎಲ್ಲಾ Phi ಮಾದರಿ ಬಳಕೆ Microsoft's ಜವಾಬ್ದಾರಿಯುತ AI ತತ್ವಗಳನ್ನು ಅನುಸರಿಸಬೇಕು:
- ನ್ಯಾಯ, ನಂಬಕತೆ, ಭದ್ರತೆ
- ಗೌಪ್ಯತೆ ಮತ್ತು ಭದ್ರತೆ  
- ಒಳಗೊಳ್ಳುವಿಕೆ, ಪಾರದರ್ಶಕತೆ, ಹೊಣೆಗಾರಿಕೆ
- ಉತ್ಪಾದನಾ ಅಪ್ಲಿಕೇಶನ್‌ಗಳಿಗೆ Azure AI ವಿಷಯ ಭದ್ರತೆ ಬಳಸಿ
- ನೋಡಿ `/md/01.Introduction/01/01.AISafety.md`

### ಅನುವಾದಗಳು

- 50+ ಭಾಷೆಗಳ ಸ್ವಯಂಚಾಲಿತ GitHub ಕ್ರಿಯೆಯ ಮೂಲಕ ಬೆಂಬಲ
- ಅನುವಾದಗಳು `/translations/` ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ ಇರುತ್ತವೆ
- ಸಹಕಾರ-ಅನುವಾದಕಾರ ಕಾರ್ಯಪ್ರವಾಹದಿಂದ ನಿರ್ವಹಿಸಲಾಗಿದೆ
- ಅನುವಾದಿತ ಕಡತಗಳನ್ನು ಕೈಯಿಂದ ಸಂಪಾದಿಸಬಾರದು (ಸ್ವಯಂ-ಸೃಷ್ಟಿ)

### ಕೊಡುಗೆ

- `CONTRIBUTING.md` ನಲ್ಲಿ ಮಾರ್ಗಸೂಚಿಗಳನ್ನು ಅನುಸರಿಸಿ
- ಸಹಕಾರಿಯ ಪರವಾನಗಿ ಒಪ್ಪಂದ (CLA) ಒಪ್ಪಿಕೊಳ್ಳಿ
- Microsoft ಓಪನ್ ಸೊರ್ಸ್ ಸಂಹಿತೆಯ ನಿಯಮ ಉಲ್ಲಂಘಿಸಬಾರದು
- ಭದ್ರತೆ ಮತ್ತು ಪ್ರಮಾಣಪತ್ರಗಳನ್ನು ಕಮಿಟ್‌ಗಳಲ್ಲಿ ಒಳಪಡಿಸಬಾರದು

### ಬಹುಭಾಷಾ ಬೆಂಬಲ

ಇದು ಬಹುಭಾಷಾ ಸಂಗ್ರಹವಾಗಿದ್ದು ಉದಾಹರಣೆಗಳು ಇವೆ:
- **Python** - ML/AI ಕಾರ್ಯಪ್ರವಾಹಗಳು, Jupyter ನೋಟ್ಬುಕ್‌ಗಳು, ಫೈನ್-ಟ್ಯೂನಿಂಗ್
- **C#/.NET** - ಎಂಟರ್ಪ್ರೈಸ್ ಅಪ್ಲಿಕೇಶನ್ಗಳು, ONNX Runtime ಒಗ್ಗೂಡಿಕೆ
- **JavaScript** - ವೆಬ್ ಆಧಾರಿತ AI, WebGPU ಬಳಸಿ ಬ್ರೌಸರ್ ಇನ್ಫರೆನ್ಸ್

ನಿಮ್ಮ ಉಪಯೋಗ ಮತ್ತು ನಿಯೋಜನೆ ಗುರಿಗೆ ಅತ್ಯುತ್ತಮವಾದ ಭಾಷೆಯನ್ನು ಆರಿಸಿ.

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ನಿರಾಕರಣೆ**:  
ಈ ದಸ್ತಾವೇಜು [Co-op Translator](https://github.com/Azure/co-op-translator) ಎಂಬ AI ಅನುವಾದ ಸೇವೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ಶುದ್ಧತೆಯ ಕಡೆ ಗಮನವಿರಿಸುತ್ತಿದ್ದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ತಪ್ಪುಗಳು ಅಥವಾ ಅಸರಿ ಸ್ನಿಹಿತತೆಗಳು ಇರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ದಸ್ತಾವೇಜಿನ ಸ್ವಂತ ಭಾಷೆ ಇದನ್ನೇ ಅಧಿಕೃತ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಮುಖ್ಯ ಮಾಹಿತಿ ಗಾಗಿ, ವೃತ್ತಿಪರವ ಮಾನವನ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆಯಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪು ತಿಳಿವಳಿಕೆಗಳು ಅಥವಾ ಅರ್ಥ ಹೇಮಾತುಗಳಿಗೆ ನಾವು ಜವಾಬ್ದಾರಿಯಲ್ಲ.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->