π OpenHands: AI-Driven Development
feat: set Canvas default model to Kimi K3 and tag it free (#16657)
Juan Pedro Michelini Jorge8989bf3bb576
diff --git a/__tests__/api/settings-service.test.ts b/__tests__/api/settings-service.test.tsindex a3c9088774..a7bb0ce74c 100644--- a/__tests__/api/settings-service.test.ts+++ b/__tests__/api/settings-service.test.ts@@ -53,7 +53,7 @@ describe("SettingsService", () => {// Should have normalized settings with derived fieldsexpect(settings.agent).toBe("CodeActAgent");- expect(settings.llm_model).toBe("openhands/glm-5.2");+ expect(settings.llm_model).toBe("openhands/kimi-k3");expect(settings.confirmation_mode).toBe(false);expect(settings.security_analyzer).toBe("llm");});diff --git a/__tests__/components/settings/llm-profiles/llm-settings-local-view.test.tsx b/__tests__/components/settings/llm-profiles/llm-settings-local-view.test.tsxindex 32124c0c2b..588854ad03 100644--- a/__tests__/components/settings/llm-profiles/llm-settings-local-view.test.tsx+++ b/__tests__/components/settings/llm-profiles/llm-settings-local-view.test.tsx@@ -331,10 +331,10 @@ describe("LlmSettingsLocalView", () => {// The profile name is auto-derived from the prefilled free default model.const nameInput = screen.getByTestId("profile-name-input");- expect(nameInput).toHaveValue("glm-5.2");+ expect(nameInput).toHaveValue("kimi-k3");expect(screen.getByTestId("mock-basic-model-input")).toHaveValue(- "openhands/glm-5.2",+ "openhands/kimi-k3",);});@@ -348,7 +348,7 @@ describe("LlmSettingsLocalView", () => {// The profile name starts from the free-model derived default.const nameInput = screen.getByTestId("profile-name-input");- expect(nameInput).toHaveValue("glm-5.2");+ expect(nameInput).toHaveValue("kimi-k3");// Go back to listawait user.click(screen.getByTestId("back-to-profiles"));@@ -360,7 +360,7 @@ describe("LlmSettingsLocalView", () => {// The profile name should return to the free-model derived default// again (fresh form).const freshNameInput = screen.getByTestId("profile-name-input");- expect(freshNameInput).toHaveValue("glm-5.2");+ expect(freshNameInput).toHaveValue("kimi-k3");});it("does not carry over values from edit mode to create mode", async () => {@@ -375,7 +375,7 @@ describe("LlmSettingsLocalView", () => {// Should be in create view with the free-model derived profile name.const nameInput = screen.getByTestId("profile-name-input");- expect(nameInput).toHaveValue("glm-5.2");+ expect(nameInput).toHaveValue("kimi-k3");// The key "new-profile" should be used, ensuring a fresh form mount// that doesn't inherit any existing profile datadiff --git a/__tests__/utils/format-model-name.test.ts b/__tests__/utils/format-model-name.test.tsindex 6a40c4df80..015177edfc 100644--- a/__tests__/utils/format-model-name.test.ts+++ b/__tests__/utils/format-model-name.test.ts@@ -17,6 +17,7 @@ describe("formatNativeModelName", () => {it("labels only configured OpenHands free-model routes as free", () => {expect(Object.keys(FREE_OPENHANDS_MODELS)).toEqual([+ "openhands/kimi-k3","openhands/glm-5.2","openhands/deepseek-v4-flash","openhands/minimax-m2.7",diff --git a/specs/llm-defaults.md b/specs/llm-defaults.mdindex 916936e1a6..4d10b1b45b 100644--- a/specs/llm-defaults.md+++ b/specs/llm-defaults.md@@ -3,7 +3,7 @@---### LLD-001: Frontend always sends its chosen default model-- [x] When the agent-server returns an absent or empty `llm.model` (e.g. because the user has never saved settings), the frontend adapter shall substitute `DEFAULT_SETTINGS.llm_model` (`"openhands/glm-5.2"`) before sending the conversation-start request.+- [x] When the agent-server returns an absent or empty `llm.model` (e.g. because the user has never saved settings), the frontend adapter shall substitute `DEFAULT_SETTINGS.llm_model` (`"openhands/kimi-k3"`) before sending the conversation-start request.- [x] The frontend shall never rely on the agent-server SDK's own default model (`gpt-5.5`); it shall always send an explicit model value.- [x] Whitespace-only model strings shall be treated as absent and fall back to the default.- [x] The same guard applies when LLM settings arrive via `encryptedAgentSettings` (the conversation-start encrypted payload path).diff --git a/src/components/features/onboarding/steps/setup-llm-step.tsx b/src/components/features/onboarding/steps/setup-llm-step.tsxindex 20c9ea6c20..bf2452bb3f 100644--- a/src/components/features/onboarding/steps/setup-llm-step.tsx+++ b/src/components/features/onboarding/steps/setup-llm-step.tsx@@ -17,7 +17,7 @@ interface SetupLlmStepProps {/*** Pre-fills the LLM form with the OpenHands provider's free default model- * (`openhands/glm-5.2`), matching `DEFAULT_SETTINGS.llm_model`. The OpenHands+ * (`openhands/kimi-k3`), matching `DEFAULT_SETTINGS.llm_model`. The OpenHands* provider is the agent the user just selected, so the onboarding override* keeps the LLM provider aligned with that choice rather than silently* switching to OpenAI. Canvas stores provider-qualified LiteLLM model ids,@@ -25,7 +25,7 @@ interface SetupLlmStepProps {* explicit override marks the model dirty so the Next button persists the* suggested default immediately.*/-export const ONBOARDING_DEFAULT_LLM_MODEL = "openhands/glm-5.2";+export const ONBOARDING_DEFAULT_LLM_MODEL = "openhands/kimi-k3";/*** Step 2: embed the LLM settings form. The screen runs in `embedded`diff --git a/src/mocks/settings-handlers.ts b/src/mocks/settings-handlers.tsindex e2da913ecf..9f5db4ca04 100644--- a/src/mocks/settings-handlers.ts+++ b/src/mocks/settings-handlers.ts@@ -595,6 +595,7 @@ const MOCK_MODELS = ["openhands/claude-sonnet-4-5-20250929","openhands/claude-haiku-4-5-20251001","openhands/claude-opus-4-5-20251101",+ "openhands/kimi-k3","openhands/glm-5.2","sambanova/Meta-Llama-3.1-8B-Instruct",];@@ -608,6 +609,7 @@ const MOCK_VERIFIED_MODELS = new Set(["openai/gpt-5.5","openhands/claude-opus-4-5-20251101","openhands/claude-sonnet-4-5-20250929",+ "openhands/kimi-k3","openhands/glm-5.2",]);@@ -733,7 +735,7 @@ export const SETTINGS_HANDLERS = ["claude-sonnet-4-5-20250929",],verified_providers: MOCK_VERIFIED_PROVIDERS,- default_model: "openhands/glm-5.2",+ default_model: "openhands/kimi-k3",}),),diff --git a/src/services/settings.ts b/src/services/settings.tsindex 6eef5a2b10..1844eb6f56 100644--- a/src/services/settings.ts+++ b/src/services/settings.ts@@ -3,7 +3,7 @@ import { Settings } from "#/types/settings";export const LATEST_SETTINGS_VERSION = 5;export const DEFAULT_SETTINGS: Settings = {- llm_model: "openhands/glm-5.2",+ llm_model: "openhands/kimi-k3",llm_base_url: "",agent: "CodeActAgent",language: "en",@@ -37,7 +37,7 @@ export const DEFAULT_SETTINGS: Settings = {agent_kind: "openhands",agent: "CodeActAgent",llm: {- model: "openhands/glm-5.2",+ model: "openhands/kimi-k3",},condenser: {enabled: true,diff --git a/src/utils/format-model-name.ts b/src/utils/format-model-name.tsindex b771b7efb1..089128b0e4 100644--- a/src/utils/format-model-name.ts+++ b/src/utils/format-model-name.ts@@ -1,6 +1,7 @@export const FREE_MODEL_BADGE_LABEL = "Free";export const FREE_OPENHANDS_MODELS = {+ "openhands/kimi-k3": "OpenHands Kimi K3 (free)","openhands/glm-5.2": "OpenHands GLM-5.2 (free)","openhands/deepseek-v4-flash": "OpenHands DeepSeek V4 Flash (free)","openhands/minimax-m2.7": "OpenHands MiniMax M2.7 (free)",diff --git a/tests/e2e/mock-llm/onboarding/mock-llm-onboarding-regressions.spec.ts b/tests/e2e/mock-llm/onboarding/mock-llm-onboarding-regressions.spec.tsindex a6c2f5edb0..9dcf8390e9 100644--- a/tests/e2e/mock-llm/onboarding/mock-llm-onboarding-regressions.spec.ts+++ b/tests/e2e/mock-llm/onboarding/mock-llm-onboarding-regressions.spec.ts@@ -99,8 +99,8 @@ test.describe("onboarding recent regressions", () => {// The model input displays the model ID without the provider prefix.await expect(modelInput,- "first-run onboarding should default to GLM-5.2",- ).toHaveValue("glm-5.2", {+ "first-run onboarding should default to Kimi K3",+ ).toHaveValue("kimi-k3", {timeout: 10_000,});await expect(diff --git a/tests/e2e/support/onboarding-helpers.ts b/tests/e2e/support/onboarding-helpers.tsindex 2b10597497..188be10d9b 100644--- a/tests/e2e/support/onboarding-helpers.ts+++ b/tests/e2e/support/onboarding-helpers.ts@@ -21,7 +21,7 @@ export async function routeOnboardingLlmCatalog(page: Page) {models: {anthropic: ["claude-opus-4-8"],openai: ["gpt-5.5"],- openhands: ["claude-opus-4-5-20251101", "glm-5.2"],+ openhands: ["claude-opus-4-5-20251101", "kimi-k3", "glm-5.2"],},}),});@@ -36,6 +36,7 @@ export async function routeOnboardingLlmCatalog(page: Page) {"anthropic/claude-opus-4-8","openai/gpt-5.5","openhands/claude-opus-4-5-20251101",+ "openhands/kimi-k3","openhands/glm-5.2",],}),