Strands Agents Samples

A model-driven approach to building AI agents in just a few lines of code.

Documentation ◆ Samples ◆ Python SDK ◆ TypeScript SDK ◆ Tools ◆ Agent Builder ◆ MCP Server

Welcome to the Strands Agents Samples repository!

Explore easy-to-use examples to get started with Strands Agents.

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

Python Prerequisites: Python 3.10 or higher pip package manager 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 strands-agents-tools Your First Agent: from strands import Agent agent = Agent() response = agent("Hello! Tell me a joke.") print(response) Explore Python tutorials →

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 →

Model Provider Setup

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

Explore the Repository

Python Samples

• 01-tutorials - Jupyter notebook tutorials covering fundamentals, multi-agent systems, and deployment
• 02-samples - Real-world use cases and industry-specific examples
• 03-integrations - Integration examples with AWS services and third-party tools
• 04-UX-demos - Full-stack applications with user interfaces
• 05-agentic-rag - Advanced Agentic RAG patterns
• 06-edge - Edge device integrations including physical AI and robotics

TypeScript Samples

• typescript/01-tutorials - Step-by-step tutorials for the TypeScript SDK

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

License

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

Security

See CONTRIBUTING for more information.