USAGE.md

# 🚀 Usage Examples

## Quick Start

### 1. Pull and Run
```bash
ollama pull radoni/vmware-infrastructure-automation-ai
ollama run radoni/vmware-infrastructure-automation-ai
```

### 2. Automatic Menu Display
The AI automatically shows this menu:

```
🏗️ VMware Infrastructure Automation - 20-Part HANDS-ON Implementation
================================================================

📚 Foundation (Parts 1-5):
  1. 🔍 Universal Discovery Engine ← START HERE
  2. 🔄 Protocol Translator 
  3. 🤖 Integration Bot
  4. ⚡ Sync Matrix
  5. 🧠 Intelligence Mapper

[... complete menu ...]

Which part? (Enter 1-20)
```

## Implementation Example

### Part 1: Universal Discovery Engine
```
You: 1

AI: # Part 1: Universal Discovery Engine - HANDS-ON EXECUTION

## Prerequisites Check
```bash
which python3 && echo "✅ Python3" || echo "❌ Install Python3"
ping -c 1 vcenter.yourdomain.com && echo "✅ vCenter reachable"
```

## EXECUTION STEPS

### Step 1: Install Dependencies
```bash
pip3 install pyvmomi requests pandas
```

### Step 2: Create Discovery Script
```python
# Save as discovery_engine.py
#!/usr/bin/env python3
import ssl
import json
from pyVim.connect import SmartConnect, Disconnect
from pyVmomi import vim
from datetime import datetime

# [Complete working script provided]
```

### Step 3: Execute
```bash
python3 discovery_engine.py
ls -la infrastructure_discovery.json
```

✅ Part 1 Complete! What's next? (1-4)
```

## Key Features

### Real Commands Only
- ✅ Copy-paste ready scripts
- ✅ Working configurations  
- ✅ Cross-platform support
- ❌ Minimal theory/explanation

### Interactive Flow
- Always starts with 20-part menu
- User selects part (1-20)
- AI provides executable implementation
- AI asks what's next

### Domain Focus
- ✅ VMware infrastructure automation
- ✅ PowerCLI, pyVmomi, REST APIs
- ❌ Refuses non-VMware topics
- ❌ Redirects to menu for off-topic queries

## Advanced Usage

### Project Structure
Creates organized automation project:
```
vmware-automation/
├── scripts/
├── config/
├── parts/01-discovery/
├── parts/02-translator/
└── ... (all 20 parts)
```

### Integration Between Parts
Each part builds on previous ones:
- Part 1 → Discovery data for Part 2
- Part 2 → API layer for Part 3
- Part 3 → Integration for Part 4
- And so on...

## Troubleshooting

### No Menu Displayed
```bash
# Restart if needed
ollama serve
ollama run radoni/vmware-infrastructure-automation-ai "hello"
```

### Wrong Response Type
The AI should always give executable commands. If not:
```bash
# Be specific
ollama run radoni/vmware-infrastructure-automation-ai "Part 1 hands-on commands"
```