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

# AWS Polly

[AWS Polly](https://aws.amazon.com/polly/) provides cloud-based TTS with natural-sounding voices across multiple languages. Supports both standard and neural engines.

<Info>
  Vision Agents requires a [Stream](https://getstream.io/try-for-free/) account
  for real-time transport. Most providers offer free tiers to get started.
</Info>

## Installation

```sh theme={null}
uv add "vision-agents[aws]"
```

## Quick Start

```python theme={null}
from vision_agents.core import Agent, User
from vision_agents.plugins import aws, gemini, deepgram, getstream

agent = Agent(
    edge=getstream.Edge(),
    agent_user=User(name="Assistant", id="agent"),
    instructions="You are a helpful assistant.",
    llm=gemini.LLM("gemini-3-flash-preview"),
    stt=deepgram.STT(),
    tts=aws.TTS(),
)
```

<Warning>
  AWS credentials are resolved via the standard AWS SDK chain (environment
  variables, AWS profiles, or IAM roles).
</Warning>

## Parameters

| Name            | Type  | Default    | Description                           |
| --------------- | ----- | ---------- | ------------------------------------- |
| `voice_id`      | `str` | `"Joanna"` | Voice ID                              |
| `engine`        | `str` | `None`     | Engine (`"standard"` or `"neural"`)   |
| `region_name`   | `str` | `None`     | AWS region                            |
| `language_code` | `str` | `None`     | Language (e.g., `"en-US"`, `"es-ES"`) |

## Neural Engine

For more natural-sounding voices:

```python theme={null}
tts = aws.TTS(engine="neural", voice_id="Joanna")
```

## SSML Support

```python theme={null}
tts = aws.TTS(text_type="ssml")
tts.send('<speak>Hello <break time="500ms"/> world!</speak>')
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Build a Voice Agent" icon="microphone" href="/introduction/voice-agents">
    Get started with voice
  </Card>

  <Card title="Build a Video Agent" icon="video" href="/introduction/video-agents">
    Add video processing
  </Card>
</CardGroup>