Strands Agent Template

🚀 GitHub Template Repository - Click "Use this template" to create your own production-ready AI agent in minutes, not days.

Skip the infrastructure setup and focus on what matters: building your agent. This template provides everything you need to deploy Strands AI agents to AWS Bedrock AgentCore Runtime with enterprise-grade observability, security, and CI/CD built-in.

What You Get

✅ Production-ready infrastructure - CDK stack with IAM, logging, tracing
✅ Local development environment - Test agents before deploying
✅ Automated CI/CD - GitHub Actions for Python + TypeScript
✅ Built-in observability - CloudWatch logs, OpenTelemetry tracing
✅ Quality tooling - Automated testing, linting, formatting

Why Python + TypeScript?

We chose Python for the agent implementation and TypeScript for infrastructure because each language offers the richest ecosystem for its respective framework. Strands provides first-class Python support with comprehensive documentation and tooling, while AWS CDK delivers the best developer experience through TypeScript. This gives you access to the most mature libraries, examples, and community resources for both domains.

As these frameworks evolve, we may consolidate to a single language for simplicity.

Quick Start

Prerequisite: install and configure the AWS CLI

# Test locally
cd agent && source .venv/bin/activate && python src/agentcore_app.py
# Test in another terminal
curl -X POST http://localhost:8080/invocations -H "Content-Type: application/json" -d '{"prompt": "What is 42 * 137?"}'

# Deploy to AWS
cd cdk && npm install && npm run build && npm run cdk:deploy

Prefer a blog post? Read about the design decisions and architecture behind this template.

Ready to build? Replace the example agent code with your own and deploy to AWS in under 10 minutes. ⚡️

See DEPLOYMENT.md for complete setup instructions.