Skip to content

docs: deprecate Kimi K2.5 from model catalog and guides#1285

Open
abhay-factory wants to merge 1 commit into
mainfrom
docs/model-update-cl-733
Open

docs: deprecate Kimi K2.5 from model catalog and guides#1285
abhay-factory wants to merge 1 commit into
mainfrom
docs/model-update-cl-733

Conversation

@abhay-factory

Copy link
Copy Markdown
Contributor

Summary

Removes Kimi K2.5 (kimi-k2.5, 0.25x multiplier) from the public docs as it has been deprecated:

  • docs/models.mdx - removed Kimi K2.5 row from Droid Core table
  • docs/cli/user-guides/choosing-your-model.mdx - removed from stack rank, reasoning settings, and open-source model list
  • docs/enterprise/hierarchical-settings-and-org-control.mdx - removed kimi-k2.5 from supported model IDs
  • Mirrored all changes in Japanese pages (docs/jp/)

Linear

CL-733

Automation session: https://app.factory.ai/sessions/52d90059-41b4-499c-b1de-71dca21a1b5d

Remove Kimi K2.5 (kimi-k2.5) from the model catalog, model selection
guide stack rank, reasoning settings, open-source model list, and
enterprise hierarchical settings supported model IDs. Mirror all
changes in Japanese pages.

Linear: CL-733

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@factory-droid

factory-droid Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Droid finished @abhay-factory's task —— View job


Security Review

The Kimi K2.5 removals look consistent across the model catalog and the guides. A few adjacent sections still have internal inconsistencies (especially around which Droid Core open models are listed, plus an inaccurate “cheapest” claim), which could mislead readers and enterprise admins configuring model policy.

@mintlify

mintlify Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
factory 🟢 Ready View Preview Jul 9, 2026, 7:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

### Open-source models

**Droid Core (GLM-5)**, **Droid Core (GLM-5.1)**, **Droid Core (Kimi K2.6)**, **Droid Core (Kimi K2.5)**, and **Droid Core (MiniMax M2.7)** are open-source alternatives available in the CLI. They're useful for:
**Droid Core (GLM-5)**, **Droid Core (GLM-5.1)**, **Droid Core (Kimi K2.6)**, and **Droid Core (MiniMax M2.7)** are open-source alternatives available in the CLI. They're useful for:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] Fix open-source model list omissions

The “Open-source models” section lists only GLM-5/GLM-5.1/Kimi K2.6/MiniMax M2.7 as the CLI's open-source alternatives, but earlier in this same guide (and in docs/models.mdx under “Droid Core (Open Models)”) you also present Nemotron 3 Ultra, MiniMax M3, and Kimi K2.7 Code as Droid Core open models. As written, readers can incorrectly conclude those models are not available via CLI/BYOK, so either include them in this list or explicitly phrase it as a non-exhaustive set (and mirror the change in the JP page).

Suggested change
**Droid Core (GLM-5)**, **Droid Core (GLM-5.1)**, **Droid Core (Kimi K2.6)**, and **Droid Core (MiniMax M2.7)** are open-source alternatives available in the CLI. They're useful for:
**Droid Core (GLM-5)**, **Droid Core (GLM-5.1)**, **Droid Core (NVIDIA Nemotron 3 Ultra)**, **Droid Core (MiniMax M3)**, **Droid Core (Kimi K2.7 Code)**, **Droid Core (Kimi K2.6)**, and **Droid Core (MiniMax M2.7)** are open-source alternatives available in the CLI. They're useful for:

- **Experimentation** with open-source model capabilities

**Note:** GLM-5 and GLM-5.1 do not support image attachments. Kimi K2.5, Kimi K2.6, and MiniMax M2.7 do support images. Kimi K2.6 adds an Off/High reasoning toggle, while MiniMax M2.7 (the cheapest model available, with 0.12× multiplier) supports Low/Medium/High reasoning. For image-based workflows, use Claude, GPT, Kimi, or MiniMax M2.7.
**Note:** GLM-5 and GLM-5.1 do not support image attachments. Kimi K2.6 and MiniMax M2.7 do support images. Kimi K2.6 adds an Off/High reasoning toggle, while MiniMax M2.7 (the cheapest model available, with 0.12× multiplier) supports Low/Medium/High reasoning. For image-based workflows, use Claude, GPT, Kimi, or MiniMax M2.7.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] Correct “cheapest model” claim in MiniMax note

The note calls MiniMax M2.7 “the cheapest model available” at 0.12×, but the same guide lists MiniMax M3 at 0.12× (and the model catalog lists additional 0.12× Droid Core models), so “cheapest” is inaccurate. Reword to “one of the cheapest” or scope the claim (for example, “cheapest model with Low/Medium/High reasoning”), and consider mentioning M3 in the image-workflow guidance since this page already describes it as multimodal (also mirror in JP).

Suggested change
**Note:** GLM-5 and GLM-5.1 do not support image attachments. Kimi K2.6 and MiniMax M2.7 do support images. Kimi K2.6 adds an Off/High reasoning toggle, while MiniMax M2.7 (the cheapest model available, with 0.12× multiplier) supports Low/Medium/High reasoning. For image-based workflows, use Claude, GPT, Kimi, or MiniMax M2.7.
**Note:** GLM-5 and GLM-5.1 do not support image attachments. Kimi K2.6, MiniMax M3, and MiniMax M2.7 do support images. Kimi K2.6 adds an Off/High reasoning toggle, while MiniMax M2.7 (one of the cheapest models available, with a 0.12× multiplier) supports Low/Medium/High reasoning. For image-based workflows, use Claude, GPT, Kimi, or MiniMax (M3 or M2.7).

Comment on lines 117 to 120
- **Droid Core (GLM-5)**: None only (default: None; no image support)
- **Droid Core (GLM-5.1)**: None only (default: None; no image support)
- **Droid Core (Kimi K2.6)**: Off / High (default: High)
- **Droid Core (Kimi K2.5)**: None only (default: None)
- **Droid Core (MiniMax M2.7)**: Low / Medium / High (default: High)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] Add Kimi K2.7 Code to reasoning effort settings

This guide describes “Droid Core (Kimi K2.7 Code)” as having optional High reasoning in the stack rank, and the model catalog lists kimi-k2.7-code as supporting Off and High (default), but the “Reasoning effort settings” section omits it. Adding it here avoids confusion about whether and how reasoning effort applies to that model (and the JP mirror has the same gap).

Suggested change
- **Droid Core (GLM-5)**: None only (default: None; no image support)
- **Droid Core (GLM-5.1)**: None only (default: None; no image support)
- **Droid Core (Kimi K2.6)**: Off / High (default: High)
- **Droid Core (Kimi K2.5)**: None only (default: None)
- **Droid Core (MiniMax M2.7)**: Low / Medium / High (default: High)
- **Droid Core (GLM-5)**: None only (default: None; no image support)
- **Droid Core (GLM-5.1)**: None only (default: None; no image support)
- **Droid Core (Kimi K2.7 Code)**: Off / High (default: High)
- **Droid Core (Kimi K2.6)**: Off / High (default: High)
- **Droid Core (MiniMax M2.7)**: Low / Medium / High (default: High)

| **Google** | `gemini-3.5-flash`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview` |
| **XAI** | `grok-code-fast-1` |
| **Open source** | `glm-5`, `glm-5.1`, `kimi-k2.5`, `kimi-k2.6`, `minimax-m2.7` |
| **Open source** | `glm-5`, `glm-5.1`, `kimi-k2.6`, `minimax-m2.7` |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] Include kimi-k2.7-code in supported open-source model IDs

docs/models.mdx lists kimi-k2.7-code under “Droid Core (Open Models)”, and the model selection guide references “Droid Core (Kimi K2.7 Code)”, but this supported model IDs table omits kimi-k2.7-code from the Open source row. That makes it unclear whether enterprise allowedModelIds/blockedModelIds can reference it, so either add the ID or clarify why it is excluded (and mirror the change in the JP enterprise page).

Suggested change
| **Open source** | `glm-5`, `glm-5.1`, `kimi-k2.6`, `minimax-m2.7` |
| **Open source** | `glm-5`, `glm-5.1`, `kimi-k2.7-code`, `kimi-k2.6`, `minimax-m2.7` |

@TheFactoriousDROID TheFactoriousDROID left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving to unblock the essential changes. Worth adding auto-review's recommended changes, but the pages they refer to are being phased out soon regardless.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants