Ollama 应用

一款现代化且易于使用的 Ollama 客户端。在完全私密且仅限于本地网络的情况下，为您提供最佳体验。

[!重要提示] 该应用不会在设备上托管 Ollama 服务器，而是通过其 API 端点连接到服务器。 不了解 Ollama 是什么？请访问 ollama.com 了解更多。

入门指南

Ollama 应用拥有简洁直观的界面，力求最大程度地开放易用。一切开箱即用，您只需按照以下步骤操作即可。

安装

您可以在 releases 标签页 中找到最新推荐版本的 Ollama 应用。下载适合您设备的可执行文件并进行安装。如果您希望在桌面平台上安装，可能还需要遵循下方“桌面版 Ollama 应用”部分中的步骤。

此外，您也可以从以下商店下载该应用：

至此，您已成功安装 Ollama 应用！现在请继续前往 初始设置 或下方的 设置。

桌面版 Ollama 应用

[!警告] 此功能目前仍处于实验阶段！部分功能可能无法按预期工作。如遇到任何问题，请提交新的 问题报告。

如果您计划使用实验性的桌面支持功能，需要注意以下几点。

Windows

Windows 版本以安装程序的形式提供，您可以在 最新发布 中找到它。该安装程序未签名，您可能需要点击“查看更多” > “仍要运行”来忽略 Windows Defender 的安全警告。

Windows 应用数据存储路径为：C:\Users\[user]\AppData\Roaming\JHubi1\Ollama App

Linux

Linux 版本以便携式可执行文件的形式提供，您可以在 最新发布 中找到它。解压后，在文件夹中执行 ./ollama 即可启动应用。

如果启动应用时出现类似 error while loading shared libraries: libgtk-3.so.0: cannot open shared object file 的错误信息，请依次执行以下命令：

• sudo apt-get update
• sudo apt-get upgrade
• sudo apt-get install packagekit-gtk3-module

Linux 应用数据存储路径为：/home/[user]/.local/share/ollama

设置

最困难的部分是配置主机。有关详细信息，请参阅 入门指南中的主机设置部分。完成设置后，通常无需再次输入。

大功告成！现在您可以开始与本地 AI 聊天，尽情享受乐趣了！

[!提示] 新的语音模式现已作为实验性功能推出。更多相关信息请参阅 文档。

文档

关于组件、设置、功能等方面的文档已迁移至本仓库的 Wiki 页面。后续版本的相关步骤将在此页面更新。仍有疑问吗？欢迎随时提交问题。

翻译与贡献

您想帮助我让这个项目变得更好吗？太好了，您的帮助将不胜感激！

Ollama 应用基于 Flutter，这是一个现代化且强大的前端框架，旨在实现一套代码在多个目标平台上运行。该框架本身使用 Dart 编程语言开发。

更多信息请参阅 贡献指南。

星标历史

Ollama App 快速上手指南

Ollama App 是一款现代化且易用的 Ollama 客户端，旨在让您在本地网络中私密、流畅地体验大语言模型。注意：本应用本身不托管 Ollama 服务，而是通过 API 连接到已有的 Ollama 服务器。

环境准备

在开始之前，请确保满足以下条件：

1. Ollama 服务端：您需要在局域网内的某台设备（可以是本机、另一台电脑或服务器）上安装并运行 Ollama 服务。
   • 如果您尚未安装，请访问 ollama.com 获取安装指南。
   • 确保 Ollama 服务已启动，并且允许局域网访问（如需远程连接，需配置 OLLAMA_HOST 环境变量）。
2. 客户端设备：
   • Android: 任意安卓手机或平板。
   • Windows: Windows 10/11。
   • Linux: 主流发行版（需具备 GTK3 支持）。
3. 网络环境：客户端设备与运行 Ollama 服务的设备必须处于同一局域网内，或网络可达。

安装步骤

Android 用户

推荐通过以下途径下载安装包：

• 官方 Release 页面：访问 GitHub Releases 下载最新版本的 APK 文件并安装。
• IzzyOnDroid 仓库：

Windows 用户

1. 前往 GitHub Releases 下载最新的 Windows 安装程序（.exe）。
2. 运行安装程序。
   • 注意：由于该应用未进行数字签名，Windows Defender 可能会拦截。若出现警告，请点击 "View More" (查看详情) > "Run Anyway" (仍要运行)。
3. 应用数据默认存储在：C:\Users\[用户名]\AppData\Roaming\JHubi1\Ollama App

Linux 用户

1. 前往 GitHub Releases 下载最新的 Linux 可执行文件（便携版）。
2. 解压下载的压缩包。
3. 在终端中进入解压后的目录，运行以下命令启动：

   ./ollama
   

4. 依赖修复：如果启动时出现 error while loading shared libraries: libgtk-3.so.0 错误，请依次执行以下命令安装缺失依赖：

   sudo apt-get update
   sudo apt-get upgrade
   sudo apt-get install packagekit-gtk3-module
   

5. 应用数据默认存储在：/home/[用户名]/.local/share/ollama

提示：桌面端（Windows/Linux）支持目前仍处于实验阶段，如遇问题请提交 Issue 反馈。

基本使用

安装完成后，请按以下步骤配置并开始对话：

1. 启动应用：打开 Ollama App。
2. 配置主机地址：
   • 首次进入时，应用会要求输入 Ollama 宿主地址（Host URL）。
   • 输入您的 Ollama 服务 API 地址（例如：http://192.168.1.100:11434）。
   • 注：具体配置细节可参考项目 Wiki 中的 "Setting up the host" 章节。配置一次后通常无需再次修改。
3. 选择模型：连接成功后，在模型选择器中挑选您已下载的模型（如 llama3, qwen2 等）。
4. 开始对话：在聊天界面输入消息，即可与本地 AI 进行交互。

新功能提示：实验性的 语音模式 (Voice Mode) 现已可用，具体使用方法请参阅项目文档中的 Components 部分。