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

Building and Previewing

Generate the static site:

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

Writing Documentation

Documentation lives in docs/ as Markdown files. The site structure is driven by src/config/navigation.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.