@aws/agentcore

<div align="center" <h1AgentCore CLI</h1 <p<strongCreate, develop, and deploy AI agents to Amazon Bedrock AgentCore</strong</p

<p <a href="https://github.com/aws/agentcore-cli/actions/workflows/build-and-test.yml"<img src="https://img.shields.io/github/actions/workflow/status/aws/agentcore-cli/build-and-test.yml?branch=main&label=build" alt="Build Status"</a <a href="https://www.npmjs.com/package/@aws/agentcore"<img src="https://img.shields.io/npm/v/@aws/agentcore" alt="npm version"</a <a href="LICENSE"<img src="https://img.shields.io/github/license/aws/agentcore-cli" alt="License"</a </p </div

Overview

Amazon Bedrock AgentCore enables you to deploy and operate AI agents securely at scale using any framework and model. AgentCore provides tools and capabilities to make agents more effective, purpose-built infrastructure to securely scale agents, and controls to operate trustworthy agents. This CLI helps you create, develop locally, and deploy agents to AgentCore with minimal configuration.

🚀 Jump Into AgentCore

• Node.js 20.x or later
• uv for Python agents (install)

Installation

Upgrading from the Bedrock AgentCore Starter Toolkit? If the old Python CLI is still installed, you'll see a warning after install asking you to uninstall it. Both CLIs use the agentcore command name, so having both can cause confusion. Uninstall the old one using whichever tool you originally used: bash pip uninstall bedrock-agentcore-starter-toolkit # if installed via pip pipx uninstall bedrock-agentcore-starter-toolkit # if installed via pipx uv tool uninstall bedrock-agentcore-starter-toolkit # if installed via uv

npm install -g @aws/agentcore

Quick Start

Use the terminal UI to walk through all commands interactively, or run each command individually:

# Launch terminal UI
agentcore

# Create a new project (wizard guides you through agent setup)
agentcore create
cd my-project

# Test locally
agentcore dev

# Deploy to AWS
agentcore deploy

Test deployed agent

agentcore invoke

## Supported Frameworks

| Framework           | Notes                                               |
| ------------------- | --------------------------------------------------- |
| Strands Agents      | AWS-native, streaming support (Python + TypeScript) |
| LangChain/LangGraph | Graph-based workflows                               |
| Google ADK          | Gemini models only                                  |
| OpenAI Agents       | OpenAI models only                                  |

## Supported Model Providers

| -------------- | ------------------------- | -------------------------------------------- | | Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 | | Anthropic | Yes | claude-sonnet-4-5-20250514 | | Google Gemini | Yes | gemini-2.5-flash | | OpenAI | Yes | gpt-4.1 |

Commands

Project Lifecycle