agent-builder
An example agent demonstrating streaming, tool use, and interactivity from your terminal. This agent builder can help you to build your own agents and tools.
claude mcp add --transport stdio strands-agents-agent-builder python -m strands_agents_builder \ --env STRANDS_KB_ENABLED="true to enable Knowledge Base integration (if applicable)" \ --env STRANDS_AGENT_BUILDER_LOG_LEVEL="Set to debug or info to control logging verbosity"
How to use
Strands Agent Builder is a Python-based command-line tool that helps you design, test, and deploy custom AI agents and tools in a streamlined workflow. It provides an interactive CLI for building specialized tools, composing agents from those tools, and orchestrating tool workflows with a focus on rapid iteration and hot-reloading during development. The built-in tool set includes capabilities for shell operations, HTTP requests, code editing actions, memory persistence, tool loading, knowledge base integration, and more, enabling you to prototype complex agent systems directly from the terminal. You can create new tools, load additional tools at runtime, and assemble agents that can delegate tasks to nested agents or coordinate multiple agents in a swarm-like setup. The result is a model-driven approach to agent development, where you describe desired capabilities and flows, then let Strands Agent Builder generate and test the corresponding tooling and agent logic.
To use it, install the package via the recommended installer, then run the interactive mode or pass a specification to build a tool or agent. The tool supports knowledge base integration for persisting and loading tools and configurations, making it suitable for long-running experiments and deployment scenarios. The available commands and tools span a wide range of tasks—from shell and HTTP interactions to Python code execution, image generation, and structured knowledge-base operations—allowing you to prototype sophisticated agent workflows without writing all boilerplate code from scratch.
How to install
Prerequisites:
- Python 3.8+ installed on your system
- PIP or an equivalent Python package manager
- Optional: a knowledge base setup if you plan to use Bedrock-powered storage
Install using pipx (recommended for isolation and easy updates):
pipx install strands-agents-builder
Alternatively, install directly with Python's package manager:
pip install strands-agents-builder
Run the interactive mode to start building agents and tools:
strands
If you prefer to run it as a module directly (e.g., in CI or an environment without pipx):
python -m strands_agents_builder
Prerequisites recap:
- Ensure Python is available on PATH
- Ensure network access to fetch the package from PyPI
- If using Bedrock features, configure AWS credentials and Bedrock access as needed
Additional notes
Tips and known considerations:
- The builder ships with a large set of built-in tools (e.g., shell, HTTP requests, editor, memory management, tool loading, and more). Review the Integrated Tools list to understand capabilities and any platform-specific limitations (e.g., some tools may be unavailable on Windows).
- Knowledge Base integration can be leveraged to persist tools, configurations, and history. Follow the KB setup sections if you plan to store and reuse tools across sessions.
- For development workflows, take advantage of hot-reloading during tool development to iterate quickly.
- Environment variables can customize behavior (e.g., log verbosity, enabling/disabling KB features). Use them to tailor the runtime to your environment.
- If you encounter permission or AWS/Bedrock-related issues, verify IAM roles, permissions, and region configurations used by any KB features.
Related MCP Servers
bytebot
Bytebot is a self-hosted AI desktop agent that automates computer tasks through natural language commands, operating within a containerized Linux desktop environment.
sdk-python
A model-driven approach to building AI agents in just a few lines of code.
ag2
AG2 (formerly AutoGen): The Open-Source AgentOS. Join us at: https://discord.gg/sNGSwQME3x
koog
Koog is the official Kotlin framework for building predictable, fault-tolerant and enterprise-ready AI agents across all platforms – from backend services to Android and iOS, JVM, and even in-browser environments. Koog is based on our AI products expertise and provides proven solutions for complex LLM and AI problems
tools
A set of tools that gives agents powerful capabilities.
samples
Agent samples built using the Strands Agents SDK.