ollama-gui

浏览器里聊本地大模型，数据不出门

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1257

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类对话助手

开发团队HelgeSverre

所属国家

官网地址https://ollama-gui.vercel.app

GitHubhttps://github.com/HelgeSverre/ollama-gui

定价模式free

价格说明开源免费，提供在线Demo，需自备Ollama服务

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,chat-ui,gui,llm,local-llm,ollama,privacy,self-hosted,typescript,vue

GitHub 星标★ 1257

30天Star增速

HF 下载量

上线时间2023-10-08 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-15

浏览次数0

项目介绍

ollama-gui 是一个基于 TypeScript 和 Vue 构建的 Web 界面，用于通过 Ollama API 与本地大语言模型对话。它解决的核心问题是：Ollama 本身只有命令行接口，普通用户难以直观地管理和切换模型、查看对话历史。该项目提供浏览器端的聊天窗口，支持模型选择、多轮对话、消息流式输出，并可将对话记录保存在本地。由于所有推理都在本机完成，数据不出设备，适合注重隐私、不想依赖云端 API 的用户。项目采用前后端分离思路，前端负责交互，后端转发请求到 Ollama 服务，部署简单，可通过 Docker 或直接 npm 运行。整体定位是轻量、自托管、开箱即用的本地 LLM 聊天前端，让不熟悉命令行的用户也能方便地使用本地模型。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

已安装并运行 Ollama（https://ollama.com/download）
Node.js 20 或更高版本
Bun（https://bun.sh），用于安装依赖和启动开发服务器
现代浏览器，用于访问 Web 界面

安装与启动步骤

1启动 Ollama 服务

确保本机 Ollama 已安装并处于运行状态，开发服务器会把 /api 转发到它的 11434 端口，因此不需要额外配置 CORS。
```
ollama serve
```
2拉取一个模型

任意模型都可以，也可以之后直接在界面里拉取。首次拉取需要下载权重，请耐心等待。
```
ollama pull llama3.2
```
3克隆项目仓库

从 GitHub 拉取 ollama-gui 源码并进入项目目录。
```
git clone https://github.com/HelgeSverre/ollama-gui.git
cd ollama-gui
```
4安装依赖

使用 Bun 安装前端依赖，需要本机已装好 Bun 与 Node.js 20+。
```
bun install
```
5启动开发服务器

启动后访问 http://localhost:5173 即可打开聊天界面，/api 会自动转发到本地 Ollama。
```
bun run dev
```
6局域网访问（可选）

加 --host 参数后，同一网络下的其他设备也能通过本机 IP 打开界面使用。
```
bun run dev --host
```
7构建静态站点（可选）

生成静态文件到 dist/ 目录，用于自行部署到反向代理或静态托管。
```
bun run build
```

关键配置

配置项	必填	说明	示例
`VITE_NO_PROXY`	否	启动开发服务器时跳过 /api 代理，直连其他 Ollama 实例	`true`
`VITE_OLLAMA_URL`	否	构建时指定 Ollama 地址；同源部署填 /	`https://ollama.example.com`
`OLLAMA_ORIGINS`	否	跨域部署时启动 Ollama 需允许的前端来源域名	`https://your-domain.com`

如何确认成功

浏览器打开 http://localhost:5173，能选择模型并收到流式回复，即表示部署成功。

常见问题

Q：需要给 Ollama 配置 CORS 吗？

A：本地开发不需要。开发服务器会把 /api 转发到 http://localhost:11434；只有前后端不同源时才需要在 Ollama 侧设置 OLLAMA_ORIGINS。

Q：对话记录存在哪里？

A：保存在浏览器本地的 IndexedDB 中，不会上传到任何服务器，只会发送给所连接的 Ollama 服务。

Q：用 HTTP 访问时有些功能不可用？

A：Gravatar 头像、Service Worker 离线缓存、持久化存储请求都需要安全上下文（HTTPS 或 localhost），HTTP 下复制文本会用兼容方案。

Q：可以连接别的机器上的 Ollama 吗？

A：可以，在 Settings → Connection 里填入该实例的地址，或用 VITE_NO_PROXY=true 启动开发服务器。

注意事项

HTTP 不会加密消息内容，在不可信网络下请改用 HTTPS。
跨域部署时前端需用 VITE_OLLAMA_URL 指定地址，并给 Ollama 设置 OLLAMA_ORIGINS。
README 中的 Docker 命令片段不完整，本教程未包含，请查阅仓库最新说明。

核心亮点

提供图形化聊天界面，无需命令行即可与本地模型对话
支持模型切换和流式输出，交互体验接近主流云端聊天产品
可自托管部署，对话数据保存在本地，隐私性好

不足之处

功能相对基础，缺少插件、联网搜索、多模态等扩展能力
文档和社区规模较小，遇到问题可参考的资料有限

适用场景

个人开发者在本地电脑上快速测试不同 Ollama 模型的效果
注重隐私的用户在离线环境中与本地 LLM 进行日常问答
团队在内网服务器部署，供成员共享使用本地模型

替代项目

open-webui、librechat

上一篇：ollama-app

下一篇：cross-platform-llm-client