Metadata-Version: 2.4
Name: agentforge-bedrock
Version: 0.2.1
Summary: AWS Bedrock provider for AgentForge — Anthropic, Titan, Cohere on Bedrock
Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
Project-URL: Documentation, https://github.com/Scaffoldic/agentforge-py
Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
Author: The AgentForge Authors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,ai,anthropic,aws,bedrock,llm
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: agentforge-core~=0.2.1
Requires-Dist: aioboto3>=13.0
Requires-Dist: botocore>=1.35
Description-Content-Type: text/markdown

# agentforge-bedrock

AWS Bedrock provider for [AgentForge](https://github.com/Scaffoldic/agentforge-py).

Implements the `LLMClient` and `EmbeddingClient` contracts from
`agentforge-core` over the AWS Bedrock Converse and embeddings APIs.

## Install

```bash
uv add agentforge-bedrock
```

## Quickstart

```python
from agentforge import Agent

# Cross-region inference profile — recommended for production.
async with Agent(model="bedrock:us.anthropic.claude-haiku-4-5-20251001-v1:0") as agent:
    result = await agent.run("Summarise the AgentForge project in one sentence.")
    print(result.output)
```

Credentials follow the standard boto3 chain (env vars, `~/.aws/credentials`,
IAM role). Pass `aws_profile=` to override.

## Model identifiers

Three forms are supported, all passed through to Bedrock unchanged:

| Form | Example |
| --- | --- |
| Region-pinned | `bedrock:anthropic.claude-3-5-sonnet-20240620-v1:0` |
| Cross-region (geo) | `bedrock:us.anthropic.claude-haiku-4-5-20251001-v1:0` |
| Cross-region (global) | `bedrock:global.anthropic.claude-sonnet-4-5-20250929-v1:0` |

Cross-region profiles route requests across destination regions
automatically, smoothing throttling and improving availability.
See [Bedrock cross-region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html).
