{"id":36442385,"url":"https://github.com/aws-samples/sample-getting-started-with-amazon-agentcore","last_synced_at":"2026-01-18T15:00:31.703Z","repository":{"id":328205567,"uuid":"1082862399","full_name":"aws-samples/sample-getting-started-with-amazon-agentcore","owner":"aws-samples","description":"This repository contains hands-on labs demonstrating the capabilities of Amazon Bedrock AgentCore, a suite of services that enables you to deploy and operate highly effective AI agents securely at scale","archived":false,"fork":false,"pushed_at":"2025-12-11T16:53:51.000Z","size":765,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-12T21:28:56.726Z","etag":null,"topics":["agentcore-sdk","agentic-ai","aws","bedrock","cloudwatch","observability","strands-agents"],"latest_commit_sha":null,"homepage":"https://builder.aws.com/content/346sGzwAP4tAi5dAz3qkwp0HlvM/bring-ai-agents-into-production-in-minutes-runtime","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-24T22:17:48.000Z","updated_at":"2025-12-11T16:53:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aws-samples/sample-getting-started-with-amazon-agentcore","commit_stats":null,"previous_names":["aws-samples/sample-getting-started-with-amazon-agentcore"],"tags_count":null,"template":false,"template_full_name":"amazon-archives/__template_MIT-0","purl":"pkg:github/aws-samples/sample-getting-started-with-amazon-agentcore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Fsample-getting-started-with-amazon-agentcore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Fsample-getting-started-with-amazon-agentcore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Fsample-getting-started-with-amazon-agentcore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Fsample-getting-started-with-amazon-agentcore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-samples","download_url":"https://codeload.github.com/aws-samples/sample-getting-started-with-amazon-agentcore/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Fsample-getting-started-with-amazon-agentcore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28538865,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T14:59:57.589Z","status":"ssl_error","status_checked_at":"2026-01-18T14:59:46.540Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentcore-sdk","agentic-ai","aws","bedrock","cloudwatch","observability","strands-agents"],"created_at":"2026-01-11T22:00:18.248Z","updated_at":"2026-01-18T15:00:31.625Z","avatar_url":"https://github.com/aws-samples.png","language":"Python","funding_links":[],"categories":["Community Projects"],"sub_categories":["For PyPI Packages"],"readme":"# Starting with Amazon Bedrock AgentCore\n\n\u003cdiv align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cp\u003e\u003cem\u003eBring AI agents into production in minutes with Amazon Bedrock AgentCore\u003c/em\u003e\n\u003c/div\u003e\n\nThis repository contains hands-on labs demonstrating the capabilities of [Amazon Bedrock AgentCore](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html), an agentic platform to build, deploy and operate agents securely at scale - using any framework and model.\n\n## What is Amazon Bedrock AgentCore?\n\nAmazon Bedrock AgentCore enables developers to accelerate AI agents into production with enterprise-grade scale, reliability, and security. AgentCore provides composable services that work with popular open-source frameworks and any model, eliminating the choice between open-source flexibility and enterprise requirements.\n\n### AgentCore Services Overview\n\n![agentcore_overview](images/agentcore_overview.png)\n\n| Service | Purpose | Key Features |\n|---------|---------|--------------|\n| **[AgentCore Runtime](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime.html)⭐** | Serverless execution | Auto-scaling, session management, container orchestration |\n| **[AgentCore Identity](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/identity.html)** | Credential management | API keys, OAuth tokens, secure vault |\n| **[AgentCore Memory](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html)⭐** | State persistence | Short-term memory, long-term storage |\n| **[AgentCore Gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)** | Connects agent to tools and data | Tool discovery, service integration |\n| **[AgentCore Code Interpreter](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/code-interpreter-tool.html)** | Code execution | Secure sandbox, data analysis |\n| **[AgentCore Browser](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/browser-tool.html)** | Web interaction | Cloud browser, auto-scaling |\n| **[AgentCore Observability](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability.html)** | Monitoring | Tracing, dashboards, debugging |\n| **[AgentCore Policy](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/policy.html)** | Security boundaries | Deterministic control, Cedar policies, natural language authoring |\n| **[AgentCore Evaluations](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/evaluations.html)** | Performance assessment | Automated testing, LLM-as-a-Judge, quality metrics |\n\n## Prerequisites\n\nBefore starting any lab, ensure you have:\n- [AWS Account](https://aws.amazon.com/account/?trk=87c4c426-cddf-4799-a299-273337552ad8\u0026sc_channel=el) with [appropriate permissions](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-permissions.html)\n- Python 3.10+ installed\n- [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)\n- Basic understanding of [AI agents](https://aws.amazon.com/what-is/ai-agents/?trk=87c4c426-cddf-4799-a299-273337552ad8\u0026sc_channel=el) and [AWS services](https://aws.amazon.com/what-is-aws/?trk=87c4c426-cddf-4799-a299-273337552ad8\u0026sc_channel=el)\n\n### Optional: Using uv for Python Project Management\n\nFor faster Python dependency management, consider using [uv](https://docs.astral.sh/uv/) instead of traditional `pip` and `venv`:\n\n```bash\n# Install dependencies with uv (faster alternative to pip)\nuv pip install -r requirements.txt\n\n# Or initialize projects with uv\nuv init my-agent-project\n```\n\nThis is optional - all labs work with standard `pip` commands as documented.\n\n## Overview\n\n| 📓 Services | 🎯 Focus \u0026 Key Learning | ⏱️ Time | 📊 Level |\n|-------------|------------------------|----------|----------|\n| **01 - [Amazon Bedrock AgentCore Runtime](./01-agentcore-runtime/)** | Serverless AI agent deployment with auto-scaling, session management, and built-in security | 10 min | ![Intermediate](https://img.shields.io/badge/-Intermediate-yellow) | \n| **02 - [Amazon Bedrock AgentCore Memory](./02-agentcore-memory/)** | Context-aware memory for conversation context and cross-session knowledge retention | 10 min | ![Intermediate](https://img.shields.io/badge/-Intermediate-yellow) | \n---\n\n## Detailed Lab Descriptions\n\n| 📓 Services | 🎯 Focus \u0026 Key Learning | 🖼️ Diagram |\n|-------------|------------------------|-------------|\n| **Amazon Bedrock AgentCore Runtime** | **Focus**: [Serverless AI Agent Deployment](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-how-it-works.html)\u003cbr\u003e\u003cbr\u003eDeploy production-ready AI agents with just 2 commands using AgentCore Runtime. This lab demonstrates:\u003cbr\u003e• Serverless agent deployment with auto-scaling\u003cbr\u003e• Session management and isolation\u003cbr\u003e• Built-in security and authentication\u003cbr\u003e• Integration with Strands Agents framework\u003cbr\u003e\u003cbr\u003e**Key Learning**: Transform prototype agents into production-ready services in minutes, not weeks. | ![image](images/lab_01_runtime.png) |\n| **Amazon Bedrock AgentCore Memory** | **Focus**: [Intelligent Memory Capabilities](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html)\u003cbr\u003e\u003cbr\u003eAdd context-aware memory to AI agents using AgentCore Memory. This lab covers:\u003cbr\u003e• Short-term memory for conversation context\u003cbr\u003e• Long-term memory for user preferences\u003cbr\u003e• Cross-session knowledge retention\u003cbr\u003e• Personalized agent experiences\u003cbr\u003e\u003cbr\u003e**Key Learning**: Build agents that remember and learn from interactions to provide more intelligent responses. | ![memory](images/high_level_memory.png) |\n\n## Getting Started\n\nEach lab includes:\n- **Prerequisites**: Required setup and dependencies\n- **Step-by-step deployment**: Automated infrastructure setup\n- **Code explanations**: Detailed implementation walkthrough\n- **Cleanup instructions**: Resource removal\n\n**Ready to deploy production AI agents?** Start with [01-agentcore-runtime](./01-agentcore-runtime/) to learn the fundamentals of AgentCore Runtime.\n\n## Resources\n\n### Documentation\n- [What is Amazon Bedrock AgentCore?](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)\n- [AgentCore Runtime How It Works](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-how-it-works.html)\n- [AgentCore Memory Guide](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html)\n- [AgentCore Gateway Documentation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html)\n- [Programmatic Agent Invocation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html#invoke-programmatically)\n\n\n### Code Examples\n- [AWS Labs AgentCore Samples](https://github.com/awslabs/amazon-bedrock-agentcore-samples/)\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-samples%2Fsample-getting-started-with-amazon-agentcore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-samples%2Fsample-getting-started-with-amazon-agentcore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-samples%2Fsample-getting-started-with-amazon-agentcore/lists"}