samples

<div align="center"> <div> <a href="https://strandsagents.com"> <img src="https://strandsagents.com/latest/assets/logo-github.svg" alt="Strands Agents" width="55px" height="105px"> </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> </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/sdk-python">Python SDK</a> ◆ <a href="https://github.com/strands-agents/tools">Tools</a> ◆ <a href="https://github.com/strands-agents/agent-builder">Agent Builder</a> ◆ <a href="https://github.com/strands-agents/mcp-server">MCP Server</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. ## 📚 Table of Contents - [📚 Table of Contents](#-table-of-contents) - [🏁 Getting Started](#-getting-started) - [Prerequisites](#prerequisites) - [Step 1: Create Virtual Environment](#step-1-create-virtual-environment) - [Step 2: Install Required Packages](#step-2-install-required-packages) - [Step 3: Setup Model Provider](#step-3-setup-model-provider) - [Step 4: Build Your First Strands Agent](#step-4-build-your-first-strands-agent) - [Step 5: Getting Started with the SDK](#step-5-getting-started-with-the-sdk) - [Step 6: Explore More Samples](#step-6-explore-more-samples) ## 🏁 Getting Started ### 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: ```bash # 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 ```bash # 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 Required Packages ```bash # Install Strands core packages (required for all examples) pip install strands-agents pip install strands-agents-tools ``` > **Additional Dependencies:** Individual examples throughout this repository may require extra packages. When working with a specific example, check for its `requirements.txt` file: > ```bash > # Navigate to the example folder you want to run > cd [example-directory] > > # Install dependencies if requirements.txt exists > pip install -r requirements.txt > ``` ### Step 3: Setup Model Provider Follow the instructions [here](https://strandsagents.com/latest/user-guide/quickstart/#model-providers) to configure your model provider and model access. ### Step 4: Build Your First Strands Agent ```python 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 5: Getting Started with the SDK Start with the [01-tutorials](./01-tutorials/) directory. Create your [first agent](./01-tutorials/01-fundamentals/01-first-agent/) and explore notebook-based examples covering core functionalities. ### Step 6: Explore the Repository This repository is organized to help you progress from basics to advanced implementations: - **[01-tutorials](./01-tutorials/)** - Step-by-step guides covering fundamentals, deployment, and best practices - **[02-samples](./02-samples/)** - Real-world use cases and industry-specific examples - **[03-integrations](./03-integrations/)** - Integration examples with AWS services and third-party tools - **[04-UX-demos](./04-UX-demos/)** - Full-stack applications with user interfaces - **[05-agentic-rag](./05-agentic-rag/)** - Advanced Agentic RAG patterns ## Contributing ❤️ We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) 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](LICENSE) file for details. ## Security See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.