# strands-agents/tools architecture

> Architecture diagram of the GitHub repository strands-agents/tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/strands-agents/tools
- Repository: https://github.com/strands-agents/tools

## Overview

##### File structure
- Top‐level packaging:
- pyproject.toml (build + dependencies)
- src/strands_tools (each .py or sub-package is one tool implementation or common util)
- src/strands_tools/utils (shared helpers & model adapters)
- docs/ (static markdown docs and tool stability matrix)
- tests/ and tests_integ/ (unit vs. integration tests organized by tool domain)
- CI & release:
- .github/workflows (lint, unit tests, integration tests, PyPI publish)
- .pre-commit-config.yaml
- Naming patterns reveal a plugin architecture: one file or subfolder = one tool provider that registers itself with Agent.

##### Key insights from the README
- There is no monolithic backend or database; most tools either call external systems or operate locally.
- The library is intended to be installed via PyPI, used as `from strands_tools import file_read, shell, use_aws, …`.
- Tools are grouped by capability (I/O, compute, cloud, memory, messaging, scheduling, automation, etc.).
- Environment variables drive behavior, and a set of common utilities underpins multiple tools.

## Diagram (Mermaid)

```mermaid
flowchart TB
    AgentCore["Agent Core (Strands SDK)"]:::external

    subgraph "Strands Tools Package"
        direction TB
        subgraph "I/O Tools"
            direction TB
            FileRead["file_read"]:::tool
            FileWrite["file_write"]:::tool
            Shell["shell"]:::tool
            Env["environment"]:::tool
            Editor["editor"]:::tool
        end
        subgraph "Compute & Code Tools"
            direction TB
            Calculator["calculator"]:::tool
            CodeInterpDir["code_interpreter"]:::tool
            PyRepl["python_repl"]:::tool
        end
        subgraph "Cloud & AI Tools"
            direction TB
            AWS["use_aws"]:::tool
            LLM["use_llm"]:::tool
            Browser["use_browser"]:::tool
            Comp["use_computer"]:::tool
            Nova["nova_reels"]:::tool
            Stability1["generate_image_stability"]:::tool
            Stability2["generate_image"]:::tool
        end
        subgraph "Memory & Vector Stores"
            direction TB
            MemGeneral["memory"]:::tool
            Mem0["mem0_memory"]:::tool
            CoreMem["agent_core_memory"]:::tool
        end
        subgraph "Messaging & HTTP Tools"
            direction TB
            HTTPReq["http_request"]:::tool
            Slack["slack"]:::tool
            RSS["rss"]:::tool
        end
        subgraph "Scheduling & Timing Tools"
            direction TB
            Cron["cron"]:::tool
            Sleep["sleep"]:::tool
            CurTime["current_time"]:::tool
        end
        subgraph "Automation & Workflows"
            direction TB
            Batch["batch"]:::tool
            Swarm["swarm"]:::tool
            Workflow["workflow"]:::tool
        end
        subgraph "Diagram & Graph Tools"
            direction TB
            Diagram["diagram"]:::tool
            Graph["graph"]:::tool
            AgentGraph["agent_graph"]:::tool
        end
        subgraph "Interaction & Control Tools"
            direction TB
            Handoff["handoff_to_user"]:::tool
            Think["think"]:::tool
            Stop["stop"]:::tool
            Speak["speak"]:::tool
            Journal["journal"]:::tool
            Retrieve["retrieve"]:::tool
        end
        subgraph "Dynamic Plugin & Clients"
            direction TB
            LoadTool["load_tool"]:::tool
            MCP["mcp_client"]:::tool
            A2A["a2a_client"]:::tool
        end
        CommonUtils["utils/*"]:::util
    end

    AgentCore -->|"loads tools"| FileRead
    AgentCore -->|"loads tools"| Calculator
    AgentCore -->|"loads tools"| AWS
    AgentCore -->|"loads tools"| MemGeneral
    AgentCore -->|"loads tools"| HTTPReq
    AgentCore -->|"loads tools"| Cron
    AgentCore -->|"loads tools"| Batch
    AgentCore -->|"loads tools"| Diagram
    AgentCore -->|"loads tools"| Handoff
    AgentCore -->|"loads tools"| LoadTool

    FileRead -->|reads| LocalFS["Local File System"]:::local
    Shell -->|executes| OSShell["OS Shell"]:::local
    PyRepl -->|executes| PythonREPL["Python REPL"]:::local
    HTTPReq -->|calls| HTTPAPI["HTTP APIs"]:::external_service
    Slack -->|calls| SlackAPI["Slack API"]:::external_service
    AWS -->|invokes| AWSCloud["AWS"]:::external_service
    MemGeneral -->|stores| VectorStores["Vector Stores"]:::data
    Nova -->|calls| NovaService["Nova Reels"]:::external_service
    Stability1 -->|calls| StabilityAI["Stability AI"]:::external_service
    Browser -->|drives| BrowserService["Headless Chromium"]:::external_service

    subgraph "CI/CD & Packaging"
        direction TB
        GHActions["GitHub Actions"]:::cicd
        PreCommit["Pre-commit"]:::cicd
        PyPI["PyPI Publish"]:::cicd
        Tests["Unit Tests"]:::documents
        TestsInt["Integration Tests"]:::documents
        GHActions -->|runs| Tests
        GHActions -->|runs| TestsInt
        GHActions -->|publishes| PyPI
    end

    Docs["docs/"]:::documents
    Pyproject["pyproject.toml"]:::cicd

    Pyproject -->|defines build| GHActions
    Docs -->|docs| FileRead
    Tests -->|test| FileRead

    click FileRead "https://github.com/strands-agents/tools/blob/main/src/strands_tools/file_read.py"
    click FileWrite "https://github.com/strands-agents/tools/blob/main/src/strands_tools/file_write.py"
    click Shell "https://github.com/strands-agents/tools/blob/main/src/strands_tools/shell.py"
    click Env "https://github.com/strands-agents/tools/blob/main/src/strands_tools/environment.py"
    click Editor "https://github.com/strands-agents/tools/blob/main/src/strands_tools/editor.py"
    click Calculator "https://github.com/strands-agents/tools/blob/main/src/strands_tools/calculator.py"
    click CodeInterpDir "https://github.com/strands-agents/tools/tree/main/src/strands_tools/code_interpreter/"
    click PyRepl "https://github.com/strands-agents/tools/blob/main/src/strands_tools/python_repl.py"
    click AWS "https://github.com/strands-agents/tools/blob/main/src/strands_tools/use_aws.py"
    click LLM "https://github.com/strands-agents/tools/blob/main/src/strands_tools/use_llm.py"
    click Browser "https://github.com/strands-agents/tools/blob/main/src/strands_tools/use_browser.py"
    click Comp "https://github.com/strands-agents/tools/blob/main/src/strands_tools/use_computer.py"
    click Nova "https://github.com/strands-agents/tools/blob/main/src/strands_tools/nova_reels.py"
    click Stability1 "https://github.com/strands-agents/tools/blob/main/src/strands_tools/generate_image_stability.py"
    click Stability2 "https://github.com/strands-agents/tools/blob/main/src/strands_tools/generate_image.py"
    click MemGeneral "https://github.com/strands-agents/tools/blob/main/src/strands_tools/memory.py"
    click Mem0 "https://github.com/strands-agents/tools/blob/main/src/strands_tools/mem0_memory.py"
    click CoreMem "https://github.com/strands-agents/tools/blob/main/src/strands_tools/agent_core_memory.py"
    click HTTPReq "https://github.com/strands-agents/tools/blob/main/src/strands_tools/http_request.py"
    click Slack "https://github.com/strands-agents/tools/blob/main/src/strands_tools/slack.py"
    click RSS "https://github.com/strands-agents/tools/blob/main/src/strands_tools/rss.py"
    click Cron "https://github.com/strands-agents/tools/blob/main/src/strands_tools/cron.py"
    click Sleep "https://github.com/strands-agents/tools/blob/main/src/strands_tools/sleep.py"
    click CurTime "https://github.com/strands-agents/tools/blob/main/src/strands_tools/current_time.py"
    click Batch "https://github.com/strands-agents/tools/blob/main/src/strands_tools/batch.py"
    click Swarm "https://github.com/strands-agents/tools/blob/main/src/strands_tools/swarm.py"
    click Workflow "https://github.com/strands-agents/tools/blob/main/src/strands_tools/workflow.py"
    click Diagram "https://github.com/strands-agents/tools/blob/main/src/strands_tools/diagram.py"
    click Graph "https://github.com/strands-agents/tools/blob/main/src/strands_tools/graph.py"
    click AgentGraph "https://github.com/strands-agents/tools/blob/main/src/strands_tools/agent_graph.py"
    click Handoff "https://github.com/strands-agents/tools/blob/main/src/strands_tools/handoff_to_user.py"
    click Think "https://github.com/strands-agents/tools/blob/main/src/strands_tools/think.py"
    click Stop "https://github.com/strands-agents/tools/blob/main/src/strands_tools/stop.py"
    click Speak "https://github.com/strands-agents/tools/blob/main/src/strands_tools/speak.py"
    click Journal "https://github.com/strands-agents/tools/blob/main/src/strands_tools/journal.py"
    click Retrieve "https://github.com/strands-agents/tools/blob/main/src/strands_tools/retrieve.py"
    click LoadTool "https://github.com/strands-agents/tools/blob/main/src/strands_tools/load_tool.py"
    click MCP "https://github.com/strands-agents/tools/blob/main/src/strands_tools/mcp_client.py"
    click A2A "https://github.com/strands-agents/tools/blob/main/src/strands_tools/a2a_client.py"
    click CommonUtils "https://github.com/strands-agents/tools/tree/main/src/strands_tools/utils/"
    click Docs "https://github.com/strands-agents/tools/tree/main/docs/"
    click Tests "https://github.com/strands-agents/tools/tree/main/tests/"
    click TestsInt "https://github.com/strands-agents/tools/tree/main/tests_integ/"
    click GHActions "https://github.com/strands-agents/tools/tree/main/.github/workflows/"
    click PreCommit "https://github.com/strands-agents/tools/blob/main/.pre-commit-config.yaml"
    click Pyproject "https://github.com/strands-agents/tools/blob/main/pyproject.toml"

    classDef tool fill:#D0E8FF,stroke:#659FD5;
    classDef external fill:#E8F1D4,stroke:#7AAE3F;
    classDef external_service fill:#E8F1D4,stroke:#7AAE3F;
    classDef local fill:#F0F0F0,stroke:#999999;
    classDef data fill:#F0F0F0,stroke:#999999;
    classDef cicd fill:#FFE0B3,stroke:#E08E00;
    classDef documents fill:#F9F0D9,stroke:#D1A400;
    classDef util fill:#DDDDF0,stroke:#6666AA;
```
