Strands Agents Samples

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

Documentation ◆ Samples ◆ Python 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.

🏁 Getting Started

Step 1: Install Required Packages

pip install strands-agents
pip install strands-agents-tools

Step 2: Setup Model Provider

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

Step 3: Build Your First Strands Agent

from strands import Agent, tool
from strands_tools import calculator, current_time, python_repl

@tool
def letter_counter(word: str, letter: str) -> int:
    """
    Count the occurrences of a specific letter in a word.
    """
    if not isinstance(word, str) or not isinstance(letter, str):
        return 0
    if len(letter) != 1:
        raise ValueError("The 'letter' parameter must be a single character")
    return word.lower().count(letter.lower())

agent = Agent(tools=[calculator, current_time, python_repl, letter_counter])

message = """
I have 4 requests:

1. What is the time right now?
2. Calculate 3111696 / 74088
3. Tell me how many letter R's are in the word "strawberry" 🍓
4. Output a script that does what we just spoke about!
   Use your python tools to confirm that the script works before outputting it
"""

agent(message)

Step 4: Getting Started with the SDK

Start with the 01-tutorials directory. Create your first agent and explore notebook-based examples covering core functionalities.

Step 5: Explore More Samples

Looking for inspiration? Check out more examples in the 02-samples folder for real-world use cases.

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.

⚠️ Preview Status

Strands Agents is currently in public preview. During this period:

APIs may change as we refine the SDK
We welcome feedback and contributions

samples