Prerequisites
- An AWS account with Bedrock enabled in your target region
- IAM access keys (or an IAM role if running on EC2/ECS)
- Model access granted in the Bedrock console for the model you want to use
Request model access
Before you can invoke a model, you must request access in the AWS console:- Open the AWS Bedrock console
- Go to Model access in the left sidebar
- Find the model (e.g. Anthropic Claude Sonnet 4) and click Request access
- Access is typically granted within a few minutes
Setup in MIRA
Enter your AWS credentials
Press ⌘, → Bedrock / AWS tab and fill in:
- AWS Access Key ID — from IAM → Users → Security credentials
- AWS Secret Access Key — shown once when you create the access key
- Session Token — optional, only for temporary/assumed-role credentials
- AWS Region — where you have Bedrock enabled (e.g.
eu-west-1)
safeStorage and stored in credentials.json.Test the connection
Click Test Connection. MIRA calls
sts:GetCallerIdentity and displays your AWS Account ID on success.Select Bedrock in the Engine tab
Press ⌘, → Engine tab → in the Provider & Model section, click the AWS Bedrock button.
Enter a model ID and region
MIRA shows suggestion chips for common Bedrock model IDs. You can also type any valid Bedrock model ID directly — any model you have access to in your account works.
Select the AWS Region that matches your Bedrock model access.
| Model | ID | Notes |
|---|---|---|
| Claude Sonnet 4 (EU) | eu.anthropic.claude-sonnet-4-20250514-v1:0 | Default — best quality |
| Claude Sonnet 4 (US) | us.anthropic.claude-sonnet-4-20250514-v1:0 | US region cross-inference |
| Claude 3.5 Sonnet v2 (EU) | eu.anthropic.claude-3-5-sonnet-20241022-v2:0 | Strong quality, high throughput |
| Claude 3.5 Sonnet v2 | anthropic.claude-3-5-sonnet-20241022-v2:0 | Without cross-region prefix |
| Claude 3.5 Haiku (EU) | eu.anthropic.claude-3-5-haiku-20241022-v1:0 | Fast, cost-effective |
| Claude 3.5 Haiku | anthropic.claude-3-5-haiku-20241022-v1:0 | Without cross-region prefix |
Required IAM permissions
The minimum IAM policy required to run MIRA with Bedrock:Cross-region inference
Theeu. and us. prefixed model IDs use Bedrock’s cross-region inference feature, which routes requests across availability zones within that geographic area for higher availability. You do not need to enable anything extra — just ensure the region in your settings matches the prefix (eu-west-1 for eu. models, us-east-1 or similar for us. models).
Default values
MIRA uses these Bedrock defaults (configurable in the Engine tab):| Setting | Default |
|---|---|
| Region | eu-west-1 |
| Model | eu.anthropic.claude-sonnet-4-20250514-v1:0 |
| Temperature | 1.0 |
| Max tokens | 8 096 |
Troubleshooting
| Error | Fix |
|---|---|
AccessDeniedException | Your IAM user lacks bedrock:InvokeModel permission — check your IAM policy |
ResourceNotFoundException | Model ID is invalid or not available in your region |
ValidationException: model access | You have not been granted access to this model — request it in the Bedrock console |
InvalidClientTokenId | Access Key ID is wrong or the key has been deleted |
SignatureDoesNotMatch | Secret Access Key is wrong |
ECONNREFUSED | No internet connection, or a corporate proxy is blocking Bedrock endpoints |
Edit this page — Open a pull
request