如何在5分钟内启动Ollama GUI：从安装到首次对话的快速教程

【免费下载链接】ollama-gui 项目地址: https://gitcode.com/gh_mirrors/ol/ollama-gui

Ollama GUI是一款直观易用的图形界面工具，专为简化Ollama AI模型的本地部署与交互而设计。通过本教程，即使是AI新手也能在5分钟内完成从安装到首次对话的全流程，轻松体验本地大模型的强大功能。

准备工作：30秒环境检查 ✅

在开始安装前，请确保您的系统满足以下条件：

• 已安装Node.js（v14.0.0+）和npm/yarn
• 已安装Git版本控制工具
• 网络连接正常（用于下载依赖和模型）

步骤1：一键克隆项目仓库 ⚡

打开终端，执行以下命令克隆官方仓库：

git clone https://gitcode.com/gh_mirrors/ol/ollama-gui
cd ollama-gui

步骤2：极速安装依赖 📦

进入项目目录后，运行以下命令安装所需依赖：

# 使用npm
npm install

# 或使用yarn
yarn install

依赖安装过程通常需要1-2分钟，取决于网络速度。

步骤3：启动应用（30秒完成）🚀

依赖安装完成后，执行启动命令：

# 开发模式启动
npm run dev

# 或使用yarn
yarn dev

启动成功后，终端会显示本地访问地址（通常为 http://localhost:5173）。

步骤4：首次使用指南 🤖

打开浏览器访问启动后的地址，您将看到Ollama GUI的主界面：

Ollama GUI直观的聊天界面，支持代码块显示和多语言切换

开始您的第一次对话：

1. 在左侧模型选择器中选择一个已下载的模型（首次使用需先通过Ollama CLI下载模型）
2. 在底部输入框中键入您的问题或指令
3. 点击发送按钮或按Enter键提交
4. 等待模型响应，对话内容会实时显示在聊天窗口中

常见问题解决 🔧

Q：启动时提示端口被占用？

A：修改vite.config.ts中的端口配置：

// vite.config.ts
export default defineConfig({
  server: {
    port: 5174 // 修改为未占用端口
  }
})

Q：如何连接远程Ollama服务？

A：在Settings界面（右上角齿轮图标）修改Base URL为远程服务地址，例如：http://your-server-ip:11434

下一步探索 🚀

• 尝试不同模型：通过Ollama CLI下载更多模型（如llama2、mistral等）
• 自定义系统提示：点击左侧"System prompt"设置对话预设
• 导出对话记录：使用聊天窗口右上角的导出功能保存重要对话

Ollama GUI让本地AI交互变得前所未有的简单，立即开始您的AI探索之旅吧！

【免费下载链接】ollama-gui 项目地址: https://gitcode.com/gh_mirrors/ol/ollama-gui