https://github.com/aws/bedrock-agentcore-sdk-python

Python SDK for transforming any AI agent into a production-ready application. Framework-agnostic primitives for runtime, memory, authentication, and tools with AWS-managed infrastructure.
https://github.com/aws/bedrock-agentcore-sdk-python

Last synced: 3 months ago
JSON representation

Python SDK for transforming any AI agent into a production-ready application. Framework-agnostic primitives for runtime, memory, authentication, and tools with AWS-managed infrastructure.

Host: GitHub
URL: https://github.com/aws/bedrock-agentcore-sdk-python
Owner: aws
License: apache-2.0
Created: 2025-07-07T22:12:31.000Z (12 months ago)
Default Branch: main
Last Pushed: 2026-01-09T17:23:11.000Z (6 months ago)
Last Synced: 2026-01-10T19:00:10.876Z (6 months ago)
Language: Python
Homepage:
Size: 694 KB
Stars: 610
Watchers: 4
Forks: 75
Open Issues: 46
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE-OF-CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Notice: NOTICE.txt

Awesome Lists containing this project

awesome-openclaw-skills - aws/bedrock-agentcore-sdk-python - ready application. Framework-agnostic pri... | 673 | (Code & Developer Tools)

README

          


  

    

      

   

  


  


    Bedrock AgentCore SDK

  


  


    Deploy your local AI agent to Bedrock AgentCore with zero infrastructure

  


  


    

    

    

    

    

    

  


  


  Documentation

    ◆ Samples

    ◆ Discord

    ◆ Boto3 Python SDK

    ◆ Runtime Python SDK

    ◆ Starter Toolkit

  



## Overview

Amazon Bedrock AgentCore enables you to deploy and operate highly effective agents securely, at scale using any framework and model. With Amazon Bedrock AgentCore, developers can accelerate AI agents into production with the scale, reliability, and security, critical to real-world deployment. AgentCore provides tools and capabilities to make agents more effective and capable, purpose-built infrastructure to securely scale agents, and controls to operate trustworthy agents. Amazon Bedrock AgentCore services are composable and work with popular open-source frameworks and any model, so you don’t have to choose between open-source flexibility and enterprise-grade security and reliability.

## 🚀 From Local Development to Bedrock AgentCore

```python

from bedrock_agentcore import BedrockAgentCoreApp

app = BedrockAgentCoreApp()

from strands import Agent # or bring your agent.

@app.entrypoint

async def handler(request):

    prompt = request.get("prompt")

    agent = Agent()

    async for event in agent.stream_async(prompt):

        yield (event)

app.run()

```

**What you get with Bedrock AgentCore:**

- ✅ **Keep your agent logic** - Works with Strands, LangGraph, CrewAI, Autogen, or custom frameworks

- ✅ **Zero infrastructure management** - No servers, containers, or scaling concerns

- ✅ **Enterprise-grade platform** - Built-in auth, memory, observability, security

- ✅ **Production-ready deployment** - Reliable, scalable, compliant hosting

## Amazon Bedrock AgentCore services

- 🚀 **Runtime** - Secure and session isolated compute: **[Runtime Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html)**

- 🧠 **Memory** - Persistent knowledge across sessions: **[Memory Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory-get-started.html)**

- 🔗 **Gateway** - Transform APIs into MCP tools: **[Gateway Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-quick-start.html)**

- 💻 **Code Interpreter** - Secure sandboxed execution: **[Code Interpreter Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/code-interpreter-getting-started.html)**

- 🌐 **Browser** - Cloud-based web automation: **[Browser Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/browser-onboarding.html)**

- 📊 **Observability** - OpenTelemetry tracing: **[Observability Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-get-started.html)**

- 🔐 **Identity** - AWS & third-party auth: **[Identity Quick Start](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/identity-getting-started-cognito.html)**

## AG-UI Protocol Support

Deploy agents using the [AG-UI protocol](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-agui.html) with zero boilerplate. A single `entrypoint` handler is served over both SSE (`POST /invocations`) and WebSocket (`/ws`).

```python

from bedrock_agentcore.runtime import serve_ag_ui

# Framework agent with a .run() method — one line

serve_ag_ui(agui_agent)

```

Or write a custom agent with the decorator form:

```python

from bedrock_agentcore.runtime import AGUIApp

from ag_ui.core import RunAgentInput, RunStartedEvent, RunFinishedEvent

app = AGUIApp()

@app.entrypoint

async def my_agent(input_data: RunAgentInput):

    yield RunStartedEvent(thread_id=input_data.thread_id, run_id=input_data.run_id)

    # ... your agent logic, yield AG-UI events ...

    yield RunFinishedEvent(thread_id=input_data.thread_id, run_id=input_data.run_id)

app.run()

```

Install with: `pip install "bedrock-agentcore[ag-ui]"`

See the [AG-UI protocol contract](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-agui-protocol-contract.html) for full details.

## 🏗️ Deployment

**Quick Start:** Use the [Bedrock AgentCore Starter Toolkit](https://github.com/aws/bedrock-agentcore-starter-toolkit) for rapid prototyping.

**Production:** [AWS CDK](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore-readme.html).

## A2A Protocol Support

Serve your agent using the [A2A (Agent-to-Agent) protocol](https://google.github.io/A2A/) on Bedrock AgentCore Runtime. Works with any framework that provides an a2a-sdk `AgentExecutor` (Strands, LangGraph, Google ADK, or custom).

```bash

pip install "bedrock-agentcore[a2a]"

```

```python

from strands import Agent

from strands.a2a import StrandsA2AExecutor

from bedrock_agentcore.runtime import serve_a2a

agent = Agent(model="us.anthropic.claude-sonnet-4-20250514", system_prompt="You are a helpful assistant.")

serve_a2a(StrandsA2AExecutor(agent))

```

See [A2A Protocol Examples](docs/examples/a2a_protocol_examples.md) for LangGraph, Google ADK, and advanced usage.

## 📝 License & Contributing

- **License:** Apache 2.0 - see [LICENSE.txt](LICENSE.txt)

- **Contributing:** See [CONTRIBUTING.md](CONTRIBUTING.md)

- **Security:** Report vulnerabilities via [SECURITY.md](SECURITY.md)