# Windows 11 చాట్ నమూనా - Foundry Local

Windows 11 కోసం ఆధునిక చాట్ అప్లికేషన్, ఇది Microsoft Foundry Local ను అందమైన స్థానిక ఇంటర్‌ఫేస్‌తో సమన్వయపరచుతుంది. Electron తో నిర్మించబడింది మరియు Microsoft యొక్క అధికారిక Foundry Local నమూనాలను అనుసరిస్తుంది.

## అవలోకనం

ఈ నమూనా Foundry Local ద్వారా స్థానిక AI మోడల్స్‌ను ఉపయోగించి ఉత్పత్తి-సిద్ధమైన చాట్ అప్లికేషన్‌ను ఎలా సృష్టించాలో చూపిస్తుంది, ఇది క్లౌడ్ ఆధారితత లేకుండా గోప్యతా-కేంద్రీకృత AI సంభాషణలను వినియోగదారులకు అందిస్తుంది.

## లక్షణాలు

### 🎨 **Windows 11 స్థానిక డిజైన్**
- Fluent Design System సమన్వయం
- మికా మెటీరియల్ ప్రభావాలు మరియు పారదర్శకత
- స్థానిక Windows 11 థీమింగ్ మద్దతు
- అన్ని స్క్రీన్ పరిమాణాలకు స్పందనాత్మక లేఅవుట్
- డార్క్/లైట్ మోడ్ ఆటోమేటిక్ స్విచ్చింగ్

### 🤖 **AI మోడల్ సమన్వయం**
- Foundry Local సేవ సమన్వయం
- హాట్-స్వాపింగ్‌తో బహుళ మోడల్ మద్దతు
- రియల్-టైమ్ స్ట్రీమింగ్ ప్రతిస్పందనలు
- స్థానిక మరియు క్లౌడ్ మోడల్ స్విచ్చింగ్
- మోడల్ ఆరోగ్య పర్యవేక్షణ మరియు స్థితి

### 💬 **చాట్ అనుభవం**
- రియల్-టైమ్ టైపింగ్ సూచికలు
- సందేశ చరిత్ర నిల్వ
- చాట్ సంభాషణలను ఎగుమతి చేయడం
- కస్టమ్ సిస్టమ్ ప్రాంప్ట్స్
- సంభాషణ శాఖలీకరణ మరియు నిర్వహణ

### ⚡ **పనితీరు లక్షణాలు**
- ఆలస్యం లోడ్ మరియు వర్చువలైజేషన్
- దీర్ఘ సంభాషణల కోసం ఆప్టిమైజ్డ్ రెండరింగ్
- బ్యాక్‌గ్రౌండ్ మోడల్ ప్రీ లోడింగ్
- సమర్థవంతమైన మెమరీ నిర్వహణ
- స్మూత్ యానిమేషన్లు మరియు మార్పులు

## నిర్మాణం

```
┌─────────────────────────────────────────────────────────────┐
│                    Windows 11 Chat App                     │
├─────────────────┬─────────────────┬─────────────────────────┤
│   Electron UI   │   IPC Bridge    │    Foundry Manager      │
│                 │                 │                         │
│ • Fluent Design │ • Secure Comms  │ • Model Loading         │
│ • Chat Interface│ • Event Routing │ • Health Monitoring     │
│ • Settings      │ • State Sync    │ • Performance Tracking │
│ • Themes        │ • Error Handler │ • Resource Management   │
└─────────────────┴─────────────────┴─────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│               Microsoft Foundry Local Service               │
│                                                             │
│ • Local Model Hosting    • OpenAI API Compatibility        │
│ • Real-time Inference    • Model Catalog Management        │
│ • Streaming Responses    • Health & Status Monitoring      │
└─────────────────────────────────────────────────────────────┘
```

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

### సిస్టమ్ అవసరాలు
- **OS**: Windows 11 (22H2 లేదా తరువాత సిఫార్సు)
- **RAM**: కనీసం 8GB, పెద్ద మోడల్స్ కోసం 16GB+ సిఫార్సు
- **స్టోరేజ్**: మోడల్స్ కోసం 10GB+ ఖాళీ స్థలం
- **GPU**: వేగవంతమైన ఇన్ఫరెన్స్ కోసం ఐచ్ఛికం కానీ సిఫార్సు

### సాఫ్ట్‌వేర్ ఆధారితాలు
- **Node.js**: v18.0.0 లేదా తరువాత
- **Foundry Local**: Microsoft నుండి తాజా వెర్షన్
- **Git**: క్లోనింగ్ మరియు అభివృద్ధికి

## ఇన్‌స్టాలేషన్

### 1. Foundry Local ఇన్‌స్టాల్ చేయండి
```powershell
# GitHub విడుదలల నుండి డౌన్‌లోడ్ చేసి ఇన్‌స్టాల్ చేయండి
winget install Microsoft.FoundryLocal

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

### 2. క్లోన్ చేసి సెటప్ చేయండి
```bash
# నమూనా డైరెక్టరీకి నావిగేట్ చేయండి
cd Module08/samples/08

# ఆధారాలను ఇన్‌స్టాల్ చేయండి
npm install

# గ్లోబల్ కాకపోతే ఎలక్ట్రాన్‌ను ఇన్‌స్టాల్ చేయండి
npm install -g electron
```

### 3. పరిసరాన్ని కాన్ఫిగర్ చేయండి
```powershell
# ఐచ్ఛికం: హైబ్రిడ్ మోడ్ కోసం క్లౌడ్ మోడల్ క్రెడెన్షియల్స్ సెట్ చేయండి
$env:AZURE_OPENAI_KEY="your-api-key"
$env:AZURE_OPENAI_ENDPOINT="your-endpoint"
$env:AZURE_OPENAI_MODEL="gpt-4"
```

### 4. అప్లికేషన్ నడపండి
```bash
# అభివృద్ధి మోడ్
npm start

# ఉత్పత్తి నిర్మాణం
npm run build
npm run dist
```

## ప్రాజెక్ట్ నిర్మాణం

```
08/
├── README.md                 # This documentation
├── package.json             # Project dependencies and scripts
├── electron.js              # Main Electron process
├── preload.js              # Secure preload script
├── src/
│   ├── index.html          # Main application UI
│   ├── styles/
│   │   ├── fluent.css      # Windows 11 Fluent Design
│   │   ├── chat.css        # Chat interface styles
│   │   └── themes.css      # Light/Dark theme support
│   ├── scripts/
│   │   ├── app.js          # Main application logic
│   │   ├── chat.js         # Chat functionality
│   │   ├── models.js       # Model management
│   │   ├── settings.js     # Settings and preferences
│   │   └── utils.js        # Utility functions
│   └── assets/
│       ├── icons/          # Application icons
│       ├── sounds/         # Notification sounds
│       └── images/         # UI images and illustrations
├── foundry/
│   ├── manager.js          # Foundry Local integration
│   └── health.js           # Health monitoring
└── build/
    ├── icon.ico            # Windows application icon
    └── installer.nsi       # NSIS installer script
```

## ముఖ్య లక్షణాల లోతైన అవగాహన

### Windows 11 సమన్వయం

**Fluent Design System**
- మికా బ్యాక్‌గ్రౌండ్ మెటీరియల్స్
- అక్రిలిక్ పారదర్శకత ప్రభావాలు
- రౌండెడ్ కార్నర్స్ మరియు ఆధునిక స్పేసింగ్
- స్థానిక Windows 11 రంగు ప్యాలెట్
- యాక్సెసిబిలిటీ కోసం సేమాంటిక్ కలర్ టోకెన్స్

**స్థానిక Windows లక్షణాలు**
- తాజా చాట్ల కోసం జంప్ లిస్ట్ సమన్వయం
- కొత్త సందేశాల కోసం Windows నోటిఫికేషన్లు
- మోడల్ ఆపరేషన్ల కోసం టాస్క్‌బార్ ప్రోగ్రెస్
- క్విక్ చర్యలతో సిస్టమ్ ట్రే సమన్వయం
- Windows Hello ప్రామాణీకరణ మద్దతు

### AI మోడల్ నిర్వహణ

**స్థానిక మోడల్స్**
```javascript
// ఆటోమేటిక్ మోడల్ కనుగొనడం మరియు లోడ్ చేయడం
const models = await foundryManager.discoverModels();
await foundryManager.loadModel('phi-4-mini');

// మోడల్ ఆరోగ్య పర్యవేక్షణ
const health = await foundryManager.checkHealth();
console.log(`Model Status: ${health.status}`);
console.log(`Memory Usage: ${health.memoryUsage}MB`);
```

**హైబ్రిడ్ క్లౌడ్/స్థానిక మద్దతు**
```javascript
// స్థానిక మరియు క్లౌడ్ మోడల్స్ మధ్య సజావుగా మార్పిడి
if (useCloudModel) {
    await chatManager.switchToCloud('gpt-4');
} else {
    await chatManager.switchToLocal('phi-4-mini');
}
```

### చాట్ ఇంటర్‌ఫేస్ లక్షణాలు

**రియల్-టైమ్ స్ట్రీమింగ్**
- టోకెన్-బై-టోకెన్ ప్రతిస్పందన ప్రదర్శన
- స్మూత్ టైపింగ్ యానిమేషన్లు
- రద్దు చేయగల అభ్యర్థనలు
- టైపింగ్ సూచికలు మరియు స్థితి

**సంభాషణ నిర్వహణ**
- నిల్వచేసిన చాట్ చరిత్ర
- సంభాషణ ఎగుమతి/ఆమదాని
- సందేశ శోధన మరియు వడపోత
- సంభాషణ శాఖలీకరణ
- ప్రతి సంభాషణకు కస్టమ్ సిస్టమ్ ప్రాంప్ట్స్

**యాక్సెసిబిలిటీ**
- పూర్తి కీబోర్డ్ నావిగేషన్
- స్క్రీన్ రీడర్ అనుకూలత
- హై కాంట్రాస్ట్ మోడ్ మద్దతు
- అనుకూలీకరించదగిన ఫాంట్ పరిమాణాలు
- వాయిస్ ఇన్‌పుట్ సమన్వయం

## ఉపయోగం ఉదాహరణలు

### ప్రాథమిక చాట్ సమన్వయం
```javascript
// చాట్ సిస్టమ్‌ను ప్రారంభించండి
const chat = new ChatManager({
    foundryEndpoint: 'http://localhost:5273',
    defaultModel: 'phi-4-mini',
    streaming: true
});

// సందేశం పంపండి
const response = await chat.sendMessage({
    content: 'Explain quantum computing',
    model: 'phi-4-mini',
    systemPrompt: 'You are a helpful physics teacher.'
});

// స్ట్రీమింగ్ ప్రతిస్పందనలను నిర్వహించండి
chat.on('chunk', (chunk) => {
    appendMessageChunk(chunk.content);
});
```

### మోడల్ నిర్వహణ
```javascript
// కొత్త మోడల్‌ను లోడ్ చేయండి
await modelManager.loadModel('qwen2.5-coder-0.5b', {
    showProgress: true,
    autoStart: true
});

// మోడల్ పనితీరును పర్యవేక్షించండి
modelManager.on('performance', (metrics) => {
    updatePerformanceUI(metrics);
});

// సంభాషణ మధ్యలో మోడల్స్ మార్చండి
await chat.switchModel('phi-4-mini', {
    preserveContext: true
});
```

### సెట్టింగ్స్ మరియు అనుకూలీకరణ
```javascript
// చాట్ ప్రవర్తనను కాన్ఫిగర్ చేయండి
const settings = {
    theme: 'system', // ఆటో, లైట్, డార్క్
    model: 'phi-4-mini',
    streaming: true,
    maxTokens: 1000,
    temperature: 0.7,
    systemPrompt: 'You are a helpful assistant.'
};

await settingsManager.updateSettings(settings);
```

## కాన్ఫిగరేషన్ ఎంపికలు

### అప్లికేషన్ సెట్టింగ్స్
- **థీమ్**: ఆటో, లైట్, డార్క్ మోడ్
- **మోడల్**: డిఫాల్ట్ మోడల్ ఎంపిక
- **పనితీరు**: ఇన్ఫరెన్స్ సెట్టింగ్స్
- **గోప్యత**: డేటా నిల్వ విధానాలు
- **నోటిఫికేషన్లు**: సందేశ అలర్ట్స్
- **షార్ట్‌కట్స్**: కీబోర్డ్ షార్ట్‌కట్స్

### చాట్ సెట్టింగ్స్
- **స్ట్రీమింగ్**: రియల్-టైమ్ ప్రతిస్పందనలను ప్రారంభించు/నిరోధించు
- **కాంటెక్స్ట్ పొడవు**: సంభాషణ జ్ఞాపకం
- **తాపన**: ప్రతిస్పందన సృజనాత్మకత
- **గరిష్ట టోకెన్లు**: ప్రతిస్పందన పొడవు పరిమితులు
- **సిస్టమ్ ప్రాంప్ట్స్**: డిఫాల్ట్ అసిస్టెంట్ ప్రవర్తన

### మోడల్ సెట్టింగ్స్
- **ఆటో-డౌన్లోడ్**: ఆటోమేటిక్ మోడల్ నవీకరణలు
- **క్యాష్ సైజ్**: స్థానిక మోడల్ నిల్వ పరిమితులు
- **పనితీరు మోడ్**: CPU vs GPU ప్రాధాన్యతలు
- **ఆరోగ్య తనిఖీలు**: పర్యవేక్షణ అంతరాలు

## అభివృద్ధి

### మూలం నుండి నిర్మాణం
```bash
# అభివృద్ధి ఆధారాలు ఇన్‌స్టాల్ చేయండి
npm install

# అభివృద్ధి మోడ్‌లో నడపండి
npm run dev

# ఉత్పత్తి కోసం నిర్మించండి
npm run build

# ఇన్‌స్టాలర్ సృష్టించండి
npm run dist
```

### డీబగ్గింగ్
```bash
# డీబగ్ మోడ్‌ను ప్రారంభించండి
set DEBUG=foundry-chat:*
npm start

# డెవలపర్ టూల్స్‌ను వీక్షించండి
# అప్లికేషన్‌లో F12 నొక్కండి
```

### పరీక్షలు
```bash
# యూనిట్ పరీక్షలను నడపండి
npm test

# ఇంటిగ్రేషన్ పరీక్షలను నడపండి
npm run test:integration

# ఎండ్-టు-ఎండ్ పరీక్షలను నడపండి
npm run test:e2e
```

## పనితీరు ఆప్టిమైజేషన్

### మెమరీ నిర్వహణ
- సమర్థవంతమైన సందేశ వర్చువలైజేషన్
- ఆటోమేటిక్ గార్బేజ్ కలెక్షన్
- మోడల్ మెమరీ పర్యవేక్షణ
- ఎగ్జిట్ సమయంలో వనరుల శుభ్రపరిచే ప్రక్రియ

### రెండరింగ్ ఆప్టిమైజేషన్
- దీర్ఘ సంభాషణల కోసం వర్చువల్ స్క్రోలింగ్
- సందేశ చరిత్ర ఆలస్యం లోడ్
- ఆప్టిమైజ్డ్ React/DOM నవీకరణలు
- GPU-వేగవంతమైన యానిమేషన్లు

### నెట్‌వర్క్ ఆప్టిమైజేషన్
- కనెక్షన్ పూలింగ్
- అభ్యర్థన బ్యాచింగ్
- ఆటోమేటిక్ రీట్రై లాజిక్
- ఆఫ్‌లైన్ మోడ్ మద్దతు

## భద్రతా పరిగణనలు

### డేటా గోప్యత
- స్థానిక-మొదటి నిర్మాణం
- క్లౌడ్ డేటా ప్రసారం లేదు (స్థానిక మోడ్)
- సంక్షిప్త సంభాషణ నిల్వ
- భద్రతా క్రెడెన్షియల్ నిర్వహణ

### అప్లికేషన్ భద్రత
- సాండ్‌బాక్స్ చేసిన రెండరర్ ప్రాసెస్‌లు
- కంటెంట్ సెక్యూరిటీ పాలసీ (CSP)
- రిమోట్ కోడ్ ఎగ్జిక్యూషన్ లేదు
- భద్రతా IPC కమ్యూనికేషన్

## సమస్య పరిష్కారం

### సాధారణ సమస్యలు

**Foundry Local ప్రారంభం కావడం లేదు**
```powershell
# సేవ స్థితిని తనిఖీ చేయండి
foundry status

# సేవను మళ్లీ ప్రారంభించండి
foundry restart

# లాగ్‌లను తనిఖీ చేయండి
foundry logs
```

**మోడల్ లోడింగ్ విఫలమవడం**
- సరిపడా డిస్క్ స్థలం ఉన్నదని నిర్ధారించుకోండి
- డౌన్లోడ్స్ కోసం ఇంటర్నెట్ కనెక్షన్ తనిఖీ చేయండి
- GPU డ్రైవర్‌లు నవీకరించబడ్డాయో చూసుకోండి
- వేరే మోడల్ వేరియంట్లను ప్రయత్నించండి

**పనితీరు సమస్యలు**
- సిస్టమ్ వనరులను పర్యవేక్షించండి
- మోడల్ సెట్టింగ్స్ సర్దుబాటు చేయండి
- హార్డ్‌వేర్ యాక్సిలరేషన్ ప్రారంభించండి
- ఇతర వనరు-గుర్తింపు అప్లికేషన్లను మూసివేయండి

### డీబగ్ మోడ్
పరిసర వేరియబుల్స్ సెట్ చేసి డీబగ్ లాగింగ్ ప్రారంభించండి:
```powershell
$env:DEBUG="foundry:*"
$env:FOUNDRY_LOG_LEVEL="debug"
```

## సహకారం

### అభివృద్ధి సెటప్
1. రిపోజిటరీని ఫోర్క్ చేయండి
2. ఫీచర్ బ్రాంచ్ సృష్టించండి
3. ఆధారితాలు ఇన్‌స్టాల్ చేయండి: `npm install`
4. మార్పులు చేసి పరీక్షించండి
5. పుల్ రిక్వెస్ట్ సమర్పించండి

### కోడ్ శైలి
- ESLint కాన్ఫిగరేషన్ అందించబడింది
- కోడ్ ఫార్మాటింగ్ కోసం Prettier
- టైప్‌స్క్రిప్ట్ టైప్ సేఫ్టీ కోసం
- డాక్యుమెంటేషన్ కోసం JSDoc వ్యాఖ్యలు

## నేర్చుకున్న ఫలితాలు

ఈ నమూనా పూర్తి చేసిన తర్వాత, మీరు అర్థం చేసుకుంటారు:

1. **Windows 11 స్థానిక అభివృద్ధి**
   - Fluent Design System అమలు
   - స్థానిక Windows సమన్వయం
   - Electron భద్రత ఉత్తమ పద్ధతులు

2. **AI మోడల్ సమన్వయం**
   - Foundry Local సేవ నిర్మాణం
   - మోడల్ జీవనచక్ర నిర్వహణ
   - పనితీరు పర్యవేక్షణ మరియు ఆప్టిమైజేషన్

3. **రియల్-టైమ్ చాట్ సిస్టమ్స్**
   - స్ట్రీమింగ్ ప్రతిస్పందన నిర్వహణ
   - సంభాషణ స్థితి నిర్వహణ
   - వినియోగదారు అనుభవ నమూనాలు

4. **ఉత్పత్తి అప్లికేషన్ అభివృద్ధి**
   - లోపాల నిర్వహణ మరియు పునరుద్ధరణ
   - పనితీరు ఆప్టిమైజేషన్
   - భద్రతా పరిగణనలు
   - పరీక్షా వ్యూహాలు

## తదుపరి దశలు

- **నమూనా 09**: బహుళ ఏజెంట్ ఆర్కెస్ట్రేషన్ సిస్టమ్
- **నమూనా 10**: Foundry Local ను టూల్స్ సమన్వయంగా ఉపయోగించడం
- **అధునాతన అంశాలు**: కస్టమ్ మోడల్ ఫైన్-ట్యూనింగ్
- **డిప్లాయ్‌మెంట్**: ఎంటర్ప్రైజ్ డిప్లాయ్‌మెంట్ నమూనాలు

## లైసెన్స్

ఈ నమూనా Microsoft Foundry Local ప్రాజెక్ట్‌తో సమానమైన లైసెన్స్‌ను అనుసరిస్తుంది.

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**అస్పష్టత**:  
ఈ పత్రాన్ని AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. అసలు పత్రం దాని స్వదేశీ భాషలోనే అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారుల కోసం మేము బాధ్యత వహించము.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->