Strands Agents is a simple yet powerful SDK that takes a model-driven approach to building and running AI agents. From simple conversational assistants to complex autonomous workflows, from local development to production deployment, Strands Agents scales with your needs.
- Lightweight & Flexible: Simple agent loop that just works and is fully customizable
- Model Agnostic: Support for Amazon Bedrock, Anthropic, LiteLLM, Llama, Ollama, OpenAI, Writer, and custom providers
- Advanced Capabilities: Multi-agent systems, autonomous agents, and streaming support
- Built-in MCP: Native support for Model Context Protocol (MCP) servers, enabling access to thousands of pre-built tools
# Install Strands Agents
pip install strands-agents strands-agents-toolsfromstrandsimportAgentfromstrands_toolsimportcalculatoragent=Agent(tools=[calculator])
agent("What is the square root of 1764")Note: For the default Amazon Bedrock model provider, you'll need AWS credentials configured and model access enabled for Claude 4 Sonnet in the us-west-2 region. See the Quickstart Guide for details on configuring other model providers.
Ensure you have Python 3.10+ installed, then:
# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows use: .venv\Scripts\activate# Install Strands and tools
pip install strands-agents strands-agents-toolsEasily build tools using Python decorators:
fromstrandsimportAgent, tool@tooldefword_count(text: str) ->int:
"""Count words in text. This docstring is used by the LLM to understand the tool's purpose. """returnlen(text.split())
agent=Agent(tools=[word_count])
response=agent("How many words are in this sentence?")Hot Reloading from Directory:
Enable automatic tool loading and reloading from the ./tools/ directory:
fromstrandsimportAgent# Agent will watch ./tools/ directory for changesagent=Agent(load_tools_from_directory=True)
response=agent("Use any tools you find in the tools directory")Seamlessly integrate Model Context Protocol (MCP) servers:
fromstrandsimportAgentfromstrands.tools.mcpimportMCPClientfrommcpimportstdio_client, StdioServerParametersaws_docs_client=MCPClient(
lambda: stdio_client(StdioServerParameters(command="uvx", args=["awslabs.aws-documentation-mcp-server@latest"]))
)
withaws_docs_client:
agent=Agent(tools=aws_docs_client.list_tools_sync())
response=agent("Tell me about Amazon Bedrock and how to use it with Python")Support for various model providers:
fromstrandsimportAgentfromstrands.modelsimportBedrockModelfromstrands.models.ollamaimportOllamaModelfromstrands.models.llamaapiimportLlamaAPIModel# Bedrockbedrock_model=BedrockModel(
model_id="us.amazon.nova-pro-v1:0",
temperature=0.3,
streaming=True, # Enable/disable streaming
)
agent=Agent(model=bedrock_model)
agent("Tell me about Agentic AI")
# Ollamaollama_model=OllamaModel(
host="http://localhost:11434",
model_id="llama3"
)
agent=Agent(model=ollama_model)
agent("Tell me about Agentic AI")
# Llama APIllama_model=LlamaAPIModel(
model_id="Llama-4-Maverick-17B-128E-Instruct-FP8",
)
agent=Agent(model=llama_model)
response=agent("Tell me about Agentic AI")Built-in providers:
Custom providers can be implemented using Custom Providers
Strands offers an optional strands-agents-tools package with pre-built tools for quick experimentation:
fromstrandsimportAgentfromstrands_toolsimportcalculatoragent=Agent(tools=[calculator])
agent("What is the square root of 1764")It's also available on GitHub via strands-agents/tools.
For detailed guidance & examples, explore our documentation:
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
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
See CONTRIBUTING for more information.