Skip to content
StPy

Strands Agents (Python)

The Python Strands Agents SDK: install, a first agent, and a path through the agent loop, model providers, tools and MCP, hooks and interrupts, multi-agent systems, observability, evals and production.

The Python SDK is the reference implementation of Strands Agents: every feature lands here first, and it has the larger tool ecosystem (strands.vended_tools, strands-agents-evals).

Install

Terminal window
pip install "strands-agents==1.64.0"

Version

strands-agents 1.64.0 · tools 0.9.0 · checked 2026-11-19 · Python 3.10+

Best for

Tool-using agents on Bedrock or any provider, multi-agent swarms and graphs, agents on AgentCore Runtime.

from strands import Agent, tool
@tool
def word_count(text: str) -> int:
"""Count the words in a piece of text.
Args:
text: The text to count.
"""
return len(text.split())
agent = Agent(
model="us.anthropic.claude-sonnet-5-5",
system_prompt="You are a concise assistant.",
tools=[word_count],
)
print(agent("How many words are in 'the quick brown fox'?"))

This uses Amazon Bedrock with your AWS credentials. To use the Anthropic or OpenAI API directly, see model providers.

Facts from the installed packages, not a full changelog:

AreaChange
strands-agents-tools 0.9Removed every tool it shipped (shell, http_request, file_read, use_aws, workflow, memory, …). Imports raise an ImportError naming the replacement in strands.vended_tools, an MCP server or MemoryManager. See the replacement table.
MCPStrands accepts mcp 1.23 up to 2.2 (exclusive), and a fresh install gets 2.x, where FastMCP is MCPServer (mcp.server.mcpserver). Servers written for mcp 1.x need that import changed.
Structured outputAgent.structured_output() is deprecated; pass structured_output_model= to the call and read result.structured_output.
Prompt cachingcache_prompt and cache_tools on BedrockModel are deprecated; use cache_config=CacheConfig(...).
Default modelWithout model=, the default Bedrock model is global.anthropic.claude-sonnet-4-6 in this release, and it changes between releases. Always set the model.

DateVersionChanges
2026-11-131.64.0Added links to the new decision-model, human-in-the-loop and background-tool sections.
2026-10-241.64.0Audit against the installed packages: corrected the mcp dependency note; added links to the new memory, voice, Bedrock OpenAI-compatible endpoint, goal-loop and steering sections.
2026-10-241.64.0New standalone Python guide, replacing the Strands page in the Amazon Bedrock guide. Comprehensive guide, tools and MCP, hooks and interrupts, multi-agent and A2A, observability and evals, recipes and production pages; every example run against the installed packages with an offline Bedrock stub.

TypeScript: the same SDK for Node.js is covered in Strands Agents (TypeScript).