在 Linux 上安装 Unsloth

在 Linux 上安装 Unsloth Desktop、Unsloth Studio 或 Unsloth Core。

要在 Linux 上安装 Unsloth Desktop，请按照以下步骤操作。

1

下载

下载适用于 Linux 的 Unsloth

2

安装

1. 打开 Unsloth 安装程序（.deb 文件）

2. 选择“安装”

3. 启动应用并等待安装完成

3

选择一个模型

打开“选择模型”或“模型中心”，选择一个模型和量化方式，然后下载。完成后即可开始聊天——无需设置。

4

Unsloth 现在已准备就绪

要开始聊天，请输入消息并按 Enter 键。

• 连接工具： Claude Code, Codex、网页搜索， MCP 等等

• 训练模型： 微调文本、扩散模型、嵌入模型等

• 生成媒体： 在本地创建和训练图像、视频、TTS

高级安装

为开发者构建版、每夜版 Unsloth Studio 或基于代码的 Unsloth Core 使用这些选项。

从主仓库安装 Unsloth Studio

git clone https://github.com/unslothai/unsloth
cd unsloth
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888

安装每夜版 Unsloth Studio

git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888

使用 uv 安装 Unsloth Core

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv unsloth_env --python 3.13
source unsloth_env/bin/activate
uv pip install unsloth --torch-backend=auto

或者直接安装最新的 pip 版本：

pip install unsloth

要使用 Unsloth 安装 vLLM：

uv pip install unsloth vllm --torch-backend=auto

关于虚拟环境、CUDA 和 Torch 特定命令，以及高级 pip 选项：

查看高级 pip 安装指南

手动安装 Unsloth Studio

下面的命令将安装 Unsloth Studio，即基于浏览器的网页界面。它不会安装原生桌面应用。

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

使用相同的命令更新 Unsloth Studio。

启动 Unsloth Studio

unsloth studio -H 0.0.0.0 -p 8888

有关详细的 Unsloth Studio 安装说明和要求， 查看 Unsloth Studio 指南.

卸载

Unsloth Desktop

Ubuntu 或 Debian（.deb)

1. 如果 Unsloth 正在运行，请先关闭它。

2. 移除软件包：

sudo apt remove unsloth

AppImage

1. 如果 Unsloth 正在运行，请先关闭它。

2. 删除已下载的 .AppImage 文件。

卸载 Unsloth Desktop 不会删除已下载的模型或你的文件。

Unsloth Studio（手动安装）

运行 Linux 卸载脚本：

curl -fsSL https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.sh | sh

这将移除 Unsloth Studio、其 CLI 命令、启动器数据以及 Linux 桌面快捷方式。它不会删除已下载的 Hugging Face 模型。

删除已下载的模型文件

默认的 Hugging Face 缓存位置是：

~/.cache/huggingface/hub/

如果 HF_HUB_CACHE, HF_HOME，或 XDG_CACHE_HOME 已设置，请改用该位置。