> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sammylabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> SAMMY - Advanced Screen-aware AI agent with real-time conversation, screen capture, and comprehensive tool integration

## What is SAMMY?

SAMMY (`@sammy-labs/sammy-three`) is designed to create sophisticated Screen-aware AI agents that can:

* **Engage in real-time voice conversations**
* **Process and capture screen content** with both render-based and video-based options
* **Manage conversation memory** with semantic search and context injection
* **Handle complex workflows** with interactive guides and walkthroughs
* **Extend capabilities** through custom tools and MCP integration
* **Monitor performance** with comprehensive observability and analytics

<Note>
  SAMMY is built for production use with worker-based architecture, advanced error handling, and performance optimization.
</Note>

## Key Features

<Columns cols={2}>
  <Card title="Real-Time Voice" icon="microphone" href="/features/audio-processing">
    Advanced audio processing with noise suppression, noise gate, and environment presets
  </Card>

  <Card title="Screen Capture" icon="camera" href="/features/render">
    Intelligent screen capture with DOM-to-image conversion and performance optimization
  </Card>

  <Card title="Memory Management" icon="database" href="/features/context-management">
    Automatic context tracking with semantic search and conversation continuity
  </Card>

  <Card title="Interactive Guides" icon="route" href="/features/guides">
    URL-based walkthrough system for onboarding and feature tours
  </Card>

  <Card title="Custom Tools" icon="wrench" href="/features/tools">
    Extensible tool system with built-in tools and MCP protocol support
  </Card>

  <Card title="Observability" icon="chart-line" href="/features/observability">
    Comprehensive event tracking, analytics, and performance monitoring
  </Card>

  <Card title="Error Handling" icon="shield-exclamation" href="/features/error-handling">
    Robust error handling with automatic recovery and user-friendly fallbacks
  </Card>

  <Card title="Voice Activity Detection" icon="microphone-lines" href="/features/vad">
    Configurable VAD settings to prevent stuttering and false interruptions
  </Card>
</Columns>

## Architecture Overview

SAMMY uses a modern, performance-focused architecture:

* **Worker-based processing** for non-blocking operations
* **Event-driven system** with type-safe event handling
* **Modular design** with composable hooks and services
* **CSP-compliant** using Data URLs for worker loading
* **Memory-efficient** with automatic cleanup and optimization

## Getting Started

Ready to build your first Screen-aware AI agent? Start with our quickstart guide:

<Card title="Quick Start Guide" icon="rocket" href="/quickstart">
  Get up and running with SAMMY in under 5 minutes
</Card>

Or explore specific features:

<Columns cols={3}>
  <Card title="Installation" icon="download" href="/quickstart#installation">
    Install and configure the package
  </Card>

  <Card title="Authentication" icon="key" href="/quickstart#authentication">
    Set up JWT authentication
  </Card>

  <Card title="Basic Usage" icon="play" href="/quickstart#basic-usage">
    Your first Screen-aware AI agent
  </Card>
</Columns>

## Use Cases

SAMMY is perfect for:

* **Customer support** with voice-enabled help systems
* **Product onboarding** with interactive guided tours
* **Internal tools** with voice-controlled interfaces
* **Educational platforms** with conversational learning
* **Accessibility features** with voice navigation
* **Complex workflows** requiring contextual assistance

## What's Next?

<Steps>
  <Step title="Installation">
    Follow our [quickstart guide](/quickstart) to install and configure SAMMY
  </Step>

  <Step title="Configuration">
    Learn about [authentication](/quickstart#authentication) and basic configuration options
  </Step>

  <Step title="Features">
    Explore advanced features like [audio processing](/features/audio-processing) and [screen capture](/features/render)
  </Step>

  <Step title="Customization">
    Add [custom tools](/features/tools) and [MCP integrations](/features/mcp) for your specific needs
  </Step>
</Steps>

<Note>
  Need help? Check out our [troubleshooting guide](/features/error-handling#troubleshooting) or explore the comprehensive [API reference](/api-reference).
</Note>