Strands Agents Documentation

A model-driven approach to building AI agents in just a few lines of code.

Documentation ◆ Samples ◆ Python SDK ◆ Tools ◆ Agent Builder ◆ MCP Server

This repository contains the documentation for the Strands Agents SDK, a simple yet powerful framework for building and running AI agents. The documentation is built using Astro with the Starlight theme and provides guides, examples, and API references.

The official documentation is available online at: https://strandsagents.com.

Local Development

Prerequisites

• Python 3.10+
• Node.js 20+, npm

Setup and Installation

npm install

Building and Previewing

Generate the static site:

npm run build

Run a local development server at http://localhost:4321/:

npm run dev

Writing Documentation

Documentation lives in docs/ as Markdown files. The site structure is driven by mkdocs.yml (navigation) and rendered by Astro at build time.

• Pages are written in standard Markdown — no Astro-specific syntax needed for content edits
• Use <Tabs> / <Tab label="..."> for language-switching code blocks (auto-imported, no import needed)
• Use --8<-- "path/to/file.ts:snippet_name" to include code snippets from external files
• Link to other pages using relative file paths (e.g. ../tools/index.md) — they resolve automatically
• Link to API reference pages using the @api shorthand: [@api/python/strands.agent.agent](#AgentResult)

For a full reference on customizations, components, and the migration status, see Site Architecture.

Contributing ❤️

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

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Security

See CONTRIBUTING for more information.