# Oshun AI Integration Video Tutorial Scripts

Scripts and outlines for video tutorials covering the Oshun AI provider
integrations. These scripts can be used to create video content or as
detailed written guides.

## Available Video Scripts

### Video 1: Getting Started with Oshun AI Integrations

**File:** `01-getting-started.md`
**Duration:** 15-20 minutes
**Level:** Beginner

Topics covered:
- Environment setup
- Provider initialization
- Text-to-speech synthesis
- Image generation
- Model discovery
- Basic error handling

### Video 2: Streaming and Real-Time AI

**File:** `02-streaming-and-real-time.md`
**Duration:** 12-15 minutes
**Level:** Intermediate

Topics covered:
- Why streaming matters
- WebSocket streaming sessions
- Real-time audio playback
- Interactive conversations
- Best practices

### Video 3: Batch Processing and Performance (Planned)

**Duration:** 15-18 minutes
**Level:** Intermediate

Topics to cover:
- Concurrency control
- Rate limiting
- Progress tracking
- Error handling in batches
- Performance optimization

### Video 4: Building Resilient AI Applications (Planned)

**Duration:** 18-22 minutes
**Level:** Advanced

Topics to cover:
- Retry patterns
- Circuit breakers
- Fallback strategies
- Resource management
- Monitoring and observability

### Video 5: Complete AI Pipeline (Planned)

**Duration:** 25-30 minutes
**Level:** Advanced

Topics to cover:
- Multi-provider orchestration
- Workflow design
- Error recovery
- Cost optimization
- Production deployment

## Script Format

Each script includes:

1. **Header** - Duration, format, target audience
2. **Video Script** - Timestamped narration
3. **Code Blocks** - Actual code to show
4. **Screen Instructions** - What to display
5. **B-Roll Suggestions** - Additional footage ideas
6. **Recording Notes** - Tips for recording

Example structure:

```markdown
### Part N: Topic (Start - End)

**[Screen: Description of what's displayed]**

> Narrator script in blockquote format

```code
// Code to show on screen
```

> More narration explaining the code
```

## Video Production Guidelines

### Technical Setup

1. **Screen Recording**
   - Resolution: 1920x1080 minimum
   - Frame rate: 30fps for screen recordings
   - Audio: High-quality microphone, no background noise

2. **Code Editor**
   - Use dark theme for contrast
   - Font size: 16-18pt for readability
   - Disable unnecessary UI elements

3. **Terminal**
   - Clear history before recording
   - Use consistent prompt style
   - Increase font size for visibility

### Narration Guidelines

1. **Pacing**
   - Speak at moderate pace (120-140 words/minute)
   - Pause after important points
   - Give viewers time to read code

2. **Tone**
   - Professional but approachable
   - Explain concepts simply
   - Avoid jargon without explanation

3. **Structure**
   - Start with what viewers will learn
   - Build concepts progressively
   - Summarize key points at end

### Post-Production

1. **Editing**
   - Remove long pauses and mistakes
   - Add zoom effects for code highlights
   - Include captions for accessibility

2. **Annotations**
   - Highlight important code sections
   - Add callout boxes for key points
   - Include timestamps in description

3. **Thumbnails**
   - Clear, readable text
   - Consistent branding
   - Show key concept visually

## Using Scripts as Written Guides

These scripts can also be used as detailed written tutorials:

1. Read the script as a step-by-step guide
2. Follow along with the code examples
3. Use the explanations as reference
4. Ignore the [Screen:] and timing annotations

## Contributing New Scripts

To create a new video script:

1. Follow the existing format
2. Include all required sections
3. Test all code examples
4. Provide clear timestamps
5. Add recording notes
6. Update this README

## Related Resources

- [Code Examples](../examples/README.md) - Working code referenced in videos
- [Exercises](../exercises/README.md) - Practice problems after watching
- [Workshops](../workshops/README.md) - Interactive learning sessions