> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/zh/kuai-su-kai-shi/install/updating.md).

# 更新 Unsloth

更新 Unsloth Desktop、Unsloth Studio 或 Unsloth Core。

### 更新 Unsloth Desktop

Unsloth Desktop 会在启动后自动检查更新。如需手动检查，请打开 **设置** → **常规** 并选择 **检查更新**.

* **macOS 和 Windows：** 选择 **立即更新**. Unsloth 会安装更新并重新启动应用程序。
* **Linux AppImage：** AppImage 版本支持应用内更新。
* **Linux `.deb`:** 从以下位置下载最新的软件包 [Linux 下载页面](https://unsloth.ai/download/linux) 并在现有版本上安装。Debian 软件包会手动安装更新。

Unsloth Desktop 的更新与手动安装的 Unsloth Studio 和 Unsloth Core 相互独立。

### 更新 Unsloth Studio

你可以使用相同的安装命令来更新

#### **macOS、Linux、WSL：**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

#### **Windows PowerShell：**

```powershell
irm https://unsloth.ai/install.ps1 | iex
```

#### **Homebrew：**

```bash
brew update && brew upgrade --cask unsloth
```

### 更新 Unsloth Core：

```bash
pip install --upgrade unsloth unsloth_zoo
```

#### 在不更新依赖项的情况下更新 Unsloth Core：

<pre class="language-bash" data-overflow="wrap"><code class="lang-bash">pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
<strong>pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo
</strong></code></pre>

### **使用旧版本**

#### **Unsloth Desktop**

要使用旧版 Unsloth Desktop，非常简单。只需查看 [我们的 GitHub 发布版本](https://github.com/unslothai/unsloth/releases) 并在“Assets”区域中选择你想安装的特定发布版本。

#### **Unsloth Studio**

要使用旧版 Unsloth Studio，请根据你需要的版本和名称按如下操作：

**macOS、Linux、WSL：**

```shellscript
uv pip install \\
  --python "$HOME/.unsloth/studio/unsloth_studio/bin/python" \\
  --reinstall --no-deps "unsloth==VERSION"

"$HOME/.unsloth/studio/unsloth_studio/bin/unsloth" studio -p 8888
```

**Windows：**

```shellscript
uv pip install `
  --python "$env:USERPROFILE\.unsloth\studio\unsloth_studio\Scripts\python.exe" `
  --reinstall --no-deps "unsloth==VERSION"

& "$env:USERPROFILE\.unsloth\studio\unsloth_studio\Scripts\unsloth.exe" studio -p 8888
```

#### **Unsloth Core**

<pre class="language-bash" data-overflow="wrap"><code class="lang-bash"><strong>pip install --force-reinstall --no-cache-dir --no-deps unsloth==2025.1.5
</strong></code></pre>

“2025.1.5” 是 Unsloth 之前的旧版本之一。请将其更改为我们列出的某个特定发布版本， [此处的 GitHub](https://github.com/unslothai/unsloth/releases).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/zh/kuai-su-kai-shi/install/updating.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.