AWS Strands Examples

This folder contains two Python examples demonstrating how to use Pipecat with the AWS Strands agent.

Overview

These examples show how to delegate complex, multi-step tasks to a Strands agent, which can reason step-by-step and call tools to accomplish user requests.

These examples are intentionally simplified for demonstration, using mock API calls. They work best if you ask it:

What's the weather where the Golden Gate Bridge is?

Example Scripts

`black-box.py`

A minimal example that demonstrates how to use the Strands agent with Pipecat. The agent can handle multi-step queries by calling tools, but does not explain its reasoning out loud.

`explain-thinking.py`

An enhanced example where the Strands agent explains each step of its reasoning in clear, simple language as it works through a multi-step task.

Quick Start

Clone the repository and navigate to this example:

git clone https://github.com/pipecat-ai/pipecat.git
cd pipecat/examples/aws-strands

Set up a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:
```
pip install -r requirements.txt
```
Configure environment variables:

Copy the provided env.example file to .env and fill in the necessary credentials:
```
cp env.example .env
# Then edit .env with your preferred editor
```

Run an example:

python black-box.py
# or
python explain-thinking.py