Skip to content
Source
Sign inSign up
TanStack/ai

packages/ai-bedrock

README.md

@tanstack/ai-bedrock

Amazon Bedrock adapter for TanStack AI — the native Converse API (default) plus the OpenAI-compatible Chat Completions and Responses APIs, with streaming, tool calling, and reasoning.

Installation

pnpm add @tanstack/ai-bedrock
# or
npm install @tanstack/ai-bedrock
# or
yarn add @tanstack/ai-bedrock

Setup

Get a Bedrock API key from the Amazon Bedrock console and set it as an environment variable:

BEDROCK_API_KEY=your-bedrock-api-key

Alternatively, configure AWS credentials for SigV4 auth (see below).

Usage

import { bedrockText } from '@tanstack/ai-bedrock'
import { chat } from '@tanstack/ai'

const adapter = bedrockText('us.anthropic.claude-haiku-4-5-20251001-v1:0', {
  region: 'us-east-1',
})

for await (const chunk of chat({
  adapter,
  messages: [{ role: 'user', content: 'Hello from Bedrock!' }],
})) {
  if (chunk.type === 'TEXT_MESSAGE_CONTENT')
    process.stdout.write(chunk.delta ?? '')
}

Responses API

import { bedrockText } from '@tanstack/ai-bedrock'

const adapter = bedrockText('openai.gpt-oss-120b-1:0', {
  region: 'us-east-1',
  api: 'responses',
})

With Explicit API Key

import { createBedrockText } from '@tanstack/ai-bedrock'

const adapter = createBedrockText(
  'us.amazon.nova-pro-v1:0',
  'your-bedrock-api-key',
  { region: 'us-west-2' },
)

Authentication

Auth is resolved in this order:

  1. Explicit apiKey passed to the factory
  2. BEDROCK_API_KEY environment variable
  3. AWS_BEARER_TOKEN_BEDROCK environment variable
  4. SigV4 via the AWS credential chain

SigV4 signing is built in — no additional packages required. On the Converse (default) path the @aws-sdk/client-bedrock-runtime client signs requests itself; the OpenAI-compatible chat/responses paths sign via the bundled @smithy/signature-v4. Set auth: 'sigv4' and provide AWS credentials through the standard credential chain (env vars, shared config, instance role):

const adapter = bedrockText('us.anthropic.claude-haiku-4-5-20251001-v1:0', {
  auth: 'sigv4',
  region: 'us-east-1',
})

Documentation

Full documentation: TanStack AI — Amazon Bedrock adapter

License

MIT