Samples AI Agent

<div align="center"> <div> <a href="https://strandsagents.com"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://strandsagents.com/latest/assets/wordmark-github-dark.svg"> <img src="https://strandsagents.com/latest/assets/wordmark-github-light.svg" alt="Strands" width="320"> </picture> </a> </div> <h1> Strands Agents Samples </h1> <h2> A model-driven approach to building AI agents in just a few lines of code. </h2> <div align="center"> <a href="https://github.com/strands-agents/samples/graphs/commit-activity"><img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/strands-agents/samples"/></a> <a href="https://github.com/strands-agents/samples/issues"><img alt="GitHub open issues" src="https://img.shields.io/github/issues/strands-agents/samples"/></a> <a href="https://github.com/strands-agents/samples/pulls"><img alt="GitHub open pull requests" src="https://img.shields.io/github/issues-pr/strands-agents/samples"/></a> <a href="https://github.com/strands-agents/samples/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/strands-agents/samples"/></a> <a href="https://discord.gg/strands"><img alt="Strands Discord" src="https://img.shields.io/badge/Discord-Strands-5865F2?logo=discord&logoColor=white"/></a> </div> <p> <a href="https://strandsagents.com/">Documentation</a> ◆ <a href="https://github.com/strands-agents/samples">Samples</a> ◆ <a href="https://github.com/strands-agents/harness-sdk/tree/main/strands-cli">CLI</a> ◆ <a href="https://github.com/strands-agents/harness-sdk/tree/main/strands-mcp">MCP Server</a> <br> Harness (<a href="https://github.com/strands-agents/harness-sdk/tree/main/harness-py">Python</a>, <a href="https://github.com/strands-agents/harness-sdk/tree/main/harness-ts">TypeScript</a>) ◆ SDK (<a href="https://github.com/strands-agents/harness-sdk/tree/main/strands-py">Python</a>, <a href="https://github.com/strands-agents/harness-sdk/tree/main/strands-ts">TypeScript</a>) ◆ <a href="https://github.com/strands-agents/box">Box</a> ◆ <a href="https://github.com/strands-agents/shell">Shell</a> ◆ <a href="https://github.com/strands-agents/evals">Evals</a> ◆ <a href="https://github.com/strands-labs">Labs</a> </p> </div>

Welcome to the Strands Agents Samples repository!

Explore easy-to-use examples to get started with <a href="https://strandsagents.com">Strands Agents</a>.

The examples in this repository are for demonstration and educational purposes only. They demonstrate concepts and techniques but are not intended for direct use in production. Always apply proper security and testing procedures before using in production environments.

Quick Start

<table> <tr> <td width="40%" valign="top">

<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/python/python-original.svg" width="24" height="24" alt="Python"/> Python

Prerequisites:

• Python 3.10 or higher
• pip package manager (not required when using the uv alternative below)
  • Verify with: pip --version or pip3 --version
  • Usually comes bundled with Python 3.4+ installers from python.org
  • If pip is missing, install using one of these methods:

    # Method 1 - Use Python's built-in module
    python -m ensurepip --upgrade
    
    # Method 2 - Download and run the official installer
    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
    python get-pip.py
    

Step 1: Create Virtual Environment

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

Step 2: Install

pip install strands-agents

This installs the core SDK, which is all the first agent below needs. Many samples need additional packages, so check each sample's README and requirements.txt or pyproject.toml before running it.

Alternative: Use uv

If you prefer uv, install it using the official installation instructions and follow these steps instead of Steps 1 and 2 above.

Create a virtual environment:

uv venv

Activate it on macOS/Linux (bash or zsh):

source .venv/bin/activate

Or on Windows (PowerShell):

.\.venv\Scripts\Activate.ps1

If PowerShell blocks Activate.ps1, see Python's Windows execution policy guidance and follow any applicable organizational policies.

Then install the same package:

uv pip install strands-agents

Your First Agent:

from strands import Agent

agent = Agent()
response = agent("Hello! Tell me a joke.")
print(response)

Explore Python tutorials →

</td> <td width="60%" valign="top">

<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/typescript/typescript-original.svg" width="24" height="24" alt="TypeScript"/> TypeScript

Prerequisites:

• Node.js 18 or higher
• npm or yarn package manager

Install:

npm install @strands-agents/sdk

Your First Agent:

import { Agent } from "@strands-agents/sdk";

async function main() {
    const agent = new Agent({
        systemPrompt: "You are a helpful assistant."
    });

    const response = await agent.invoke("Hello! Tell me a joke.");
    console.log(response.toString());
}

main();

Explore TypeScript tutorials →

</td> </tr> </table>

Model Provider Setup

Follow the instructions here to configure your model provider and model access.

Explore the Repository

<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/python/python-original.svg" width="20" height="20"/> Python Samples

• 01-learn - SDK tutorials covering fundamentals, multi-agent systems, and streaming
• 02-deploy - Deployment patterns for Lambda, Fargate, and AgentCore
• 03-integrate - Integrations with AWS services, databases, and third-party tools
• 04-industry-use-cases - Industry applications (finance, healthcare, retail, productivity, etc.)
• 05-technical-use-cases - Architectural patterns including Agentic RAG
• 06-evaluate - Evaluation tutorials and testing patterns
• 07-ux-demos - Full-stack applications with user interfaces
• 08-edge - Edge device integrations including physical AI and robotics

<img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/typescript/typescript-original.svg" width="20" height="20"/> TypeScript Samples

• 01-learn - SDK tutorials for the TypeScript SDK
• 02-deploy - Deployment patterns for AgentCore

Contributing ❤️

We welcome contributions! See our Contributing Guide for details on:

• Reporting bugs & features
• Development setup
• Contributing via Pull Requests
• Code of Conduct
• Reporting of security issues

Stay in touch with the team

Come meet the Strands team and other users on Discord

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Security

See CONTRIBUTING for more information.