Skip to content

Commit a128f55

Browse files
committed
docs: update LOCAL_AWS_SETUP.md with corrected model config keys and new notes
1 parent 998ffb5 commit a128f55

1 file changed

Lines changed: 17 additions & 20 deletions

File tree

LOCAL_AWS_SETUP.md

Lines changed: 17 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -69,44 +69,38 @@ Create `~/.config/opencode/opencode.json`:
6969
"region": "<your-preferred-region>"
7070
},
7171
"models": {
72-
"writer.palmyra-x4": {
73-
"id": "us.writer.palmyra-x4-v1:0",
72+
"writer.palmyra-x4-v1:0": {
7473
"name": "Writer Palmyra X4",
7574
"tool_call": false,
7675
"limit": { "context": 128000, "output": 8192 }
7776
},
78-
"writer.palmyra-x5": {
79-
"id": "us.writer.palmyra-x5-v1:0",
77+
"writer.palmyra-x5-v1:0": {
8078
"name": "Writer Palmyra X5",
8179
"tool_call": false,
8280
"limit": { "context": 1000000, "output": 8192 }
8381
},
84-
"deepseek.r1": {
85-
"id": "us.deepseek.r1-v1:0",
86-
"name": "DeepSeek R1",
82+
"deepseek.r1-v1:0": {
83+
"name": "DeepSeek R1 (A)",
8784
"tool_call": false,
85+
"reasoning": false,
8886
"limit": { "context": 64000, "output": 32768 }
8987
},
90-
"mistral.pixtral-large-2502": {
91-
"id": "us.mistral.pixtral-large-2502-v1:0",
88+
"mistral.pixtral-large-2502-v1:0": {
9289
"name": "Mistral Pixtral Large",
9390
"tool_call": false,
9491
"limit": { "context": 128000, "output": 8192 }
9592
},
96-
"meta.llama4-maverick-17b-instruct": {
97-
"id": "us.meta.llama4-maverick-17b-instruct-v1:0",
93+
"meta.llama4-maverick-17b-instruct-v1:0": {
9894
"name": "Meta Llama 4 Maverick 17B",
9995
"tool_call": false,
10096
"limit": { "context": 1000000, "output": 8192 }
10197
},
102-
"meta.llama4-scout-17b-instruct": {
103-
"id": "us.meta.llama4-scout-17b-instruct-v1:0",
98+
"meta.llama4-scout-17b-instruct-v1:0": {
10499
"name": "Meta Llama 4 Scout 17B",
105100
"tool_call": false,
106101
"limit": { "context": 10000000, "output": 8192 }
107102
},
108-
"amazon.nova-2-lite": {
109-
"id": "us.amazon.nova-2-lite-v1:0",
103+
"amazon.nova-2-lite-v1:0": {
110104
"name": "Amazon Nova 2 Lite",
111105
"limit": { "context": 300000, "output": 5120 }
112106
}
@@ -116,11 +110,11 @@ Create `~/.config/opencode/opencode.json`:
116110
}
117111
```
118112

119-
> **Note on `tool_call: false`:** Models marked with `tool_call: false` do not support
120-
> tool use in streaming mode on Bedrock. This config prevents opencode from sending
121-
> tool definitions to those models. The `flex` branch includes a fix that makes
122-
> `tool_call: false` actually respected at runtime — see the tracking PR
123-
> [flexion/opencode#2](https://github.com/flexion/opencode/pull/2) for details.
113+
> **Notes on model config keys:** Config keys must match the snapshot model ID exactly (e.g. `writer.palmyra-x5-v1:0`) — the `us.` cross-region inference profile prefix is added automatically at runtime for supported models and regions. The `id` field is only needed if you want the key to differ from the API model ID.
114+
>
115+
> **`tool_call: false`:** Models marked with `tool_call: false` do not support tool use in streaming mode on Bedrock. This prevents opencode from sending tool definitions to those models.
116+
>
117+
> **`reasoning: false`:** Models marked with `reasoning: false` will have reasoning content stripped from message history before being sent to the model. Required for models like DeepSeek R1 on Bedrock that generate reasoning output but reject it as input in subsequent turns.
124118
125119
### 3. Shell alias
126120

@@ -173,6 +167,9 @@ See [flexion/opencode#2](https://github.com/flexion/opencode/pull/2) for the ful
173167
| Hide skill prompt text from chat UI | `packages/opencode/src/session/prompt.ts` | Marks skill template as `synthetic` so the full prompt is sent to the model but hidden from the user |
174168
| Respect `tool_call: false` at runtime | `packages/opencode/src/session/llm.ts` | Gates tool resolution behind `capabilities.toolcall` — fixes failures on Bedrock models that don't support streaming + tool use |
175169
| Re-sign macOS binaries after build | `packages/opencode/script/build.ts` | Strips Bun's embedded signature and applies a fresh ad-hoc one — fixes SIGKILL (exit 137) on Darwin 25+ where Bun's signature format is rejected |
170+
| Add inference profile prefixes for palmyra and pixtral | `packages/opencode/src/provider/provider.ts` | Adds `us.` cross-region inference profile prefix for Writer Palmyra and Mistral Pixtral models in US regions |
171+
| Strip reasoning from history for non-reasoning models | `packages/opencode/src/provider/transform.ts` | Removes reasoning content parts from assistant message history before sending to models with `reasoning: false` — fixes Bedrock rejections when switching from a reasoning model |
172+
| Exclude palmyra from reasoning variant generation | `packages/opencode/src/provider/transform.ts` | Prevents unsupported `reasoningConfig` parameters from being sent to Writer Palmyra models |
176173
| Local build & AWS Bedrock setup docs | `LOCAL_AWS_SETUP.md` | This file |
177174

178175
Full details and upstream tracking: [flexion/opencode#2](https://github.com/flexion/opencode/pull/2)

0 commit comments

Comments
 (0)