kelivo README

项目的 README,来自 github.com/Chevey339/kelivo。合并为一个 markdown 文件:README.md。

Kelivo

Kelivo

An open-source LLM client for mobile and desktop.

Use every major model in one app, give it a workspace to get real work done, and keep your data on your own device.

Latest release Downloads Stars License Built with Flutter

Discord QQ Group

Chevey339%2Fkelivo | Trendshift

Website · User Guide · Download · Report an Issue

English · 简体中文

💡 Overview

Kelivo is a cross-platform LLM client built with Flutter for Android, iOS, macOS, Windows and Linux. Connect your own API keys or sign in with a supported subscription, and switch between OpenAI, Gemini, Claude, DeepSeek, OpenRouter and any OpenAI-compatible service without switching apps.

Kelivo goes beyond chat. Models can search the web, call MCP servers, follow skills and remember what matters to you. Bind a conversation to a workspace and the model can read and edit files and run commands: inside a Linux sandbox on your phone, or in a native shell on your computer.

Conversations, settings and files are stored locally. Kelivo has no account system of its own; back up to WebDAV or S3-compatible storage whenever you choose.

💖 Sponsors

STA1N API
STA1N API🍪
Thanks to STA1N API🍪 for sponsoring Kelivo! An API service focused on roleplay (RP) and character chat.
10dian-API
10dian-API
Thanks to 10dian-API for sponsoring Kelivo! 10dian-API provides secure, fast and stable API services for developers and AI enthusiasts, with transparent, affordable pricing and a focus on user experience. It promises 100% genuine models with no substitution. One key to unlock a world of AI!
随想AI中转
随想AI中转
感谢随想AI中转对本项目的赞助!随想AI中转 是一家可靠高效的 API 中继服务提供商,提供 Claude、Codex、Gemini 等的中继服务。注重隐私的中转站·无数据倒卖·无模型掺水,隐私,透明,极速售后。新账户注册每日签到就送 0.5 元测试额度,充值额度 1:1,无需订阅,按量付费。多线路冗余、跨区域容灾、自动故障切换,长链路 SSE 不中断。99.9% 可用性,关键调用从不掉队。
MaruCode MaruCode 是一家偶尔做做慈善的小破站 API,自营号池,主要提供 Codex、Claude Code、GPT Image 等主流模型,支持 Websocket 协议,明码标价(Codex 0.25x, CC 1.5x),透明汇率(1:1),新用户注册送 2 刀。生图工作台🖼️
砂糖酒馆 Thanks to 砂糖酒馆 for sponsoring Kelivo! Focused on character chat with transparent, per-request pricing. Offers mainstream text models including Gemini, Claude, DeepSeek and GLM, plus NAI image generation, TTS and video models. Prioritizes privacy, with no data reselling or model substitution, and a 1:1 recharge credit ratio. Purchase credits.

If Kelivo is useful to you, you can also support the project on WeChat.

📸 Screenshots

Chat with Markdown, tables and math Agent working in a workspace Terminal in the Linux sandbox Web search with citations

🚀 Download

Platform Get Kelivo Package Requirements
iOS / iPadOS App Store · TestFlight (beta) App Store, or unsigned IPA in Releases iOS 15.0 or later
Android GitHub Releases APK (arm64-v8a, armeabi-v7a, x86_64) Android 7.0 or later
macOS GitHub Releases DMG macOS 12.0 or later, Apple silicon or Intel
Windows GitHub Releases Installer (setup.exe) or portable ZIP Windows 10 or 11
Linux GitHub Releases AppImage, DEB, RPM, tar.gz x86_64
HarmonyOS kelivo-ohos Maintained in a separate repository —

The download page on the website lists the same builds.

🧭 Getting Started

  1. Add a model provider. Open Settings → Providers, enter an API key for a preset provider or add your own endpoint, then fetch its model list. To use a ChatGPT, Grok or Kimi Code account instead, sign in from the Accounts tab under Add Provider.
  2. Start a conversation. Select a model from the input bar. Turn on web search, MCP servers, tools or reasoning for the current chat from the same bar.
  3. Let the model work with files (optional). Open Settings → Workspace & environment and create a workspace, then bind it to a conversation from the chat. On Android and iOS, install the Linux environment on the same page first; the iOS environment is bundled with the app, so nothing is downloaded.

The User Guide (Chinese) covers providers, memory, world books and more.

✨ Features

🧠 Models and Providers

🤖 Agent and Workspaces

🧩 Assistants, Memory and Context

🔍 Search, Voice and Vision

📝 Reading and Organizing

🎨 Appearance

🔒 Data and Privacy

🔗 System Integration

📊 Platform Differences

Most features work on every platform. These depend on the operating system:

Capability Android iOS macOS / Windows / Linux
Workspace runtime Linux sandbox (PRoot) Linux sandbox (iSH) Native shell
Linux distributions Ubuntu, Debian, Alpine or imported rootfs Alpine (included) —
Terminal In-app In-app System terminal
Access to outside folders Up to 10 mounted folders Up to 10 mounted folders Link any local folder
MCP over STDIO In sandbox In sandbox Native
Scheduled tasks ✓ — ✓
Background generation Notification, Live Updates, floating capsule Extra background time, Live Activities While Kelivo is running
Platform-specific device tools Calendar, location, screen time Calendar, location, weather, reminders, Health —
Global shortcut and system tray — — ✓

On desktop, workspace commands run with your user account's permissions and are not sandboxed. Keep command approval turned on for workspaces that contain important files.

🔧 Building from Source

Requirements

git clone https://github.com/Chevey339/kelivo.git
cd kelivo
flutter pub get
flutter run

Several packages are vendored under dependencies/ and referenced by path, so no extra setup is needed for them. See AGENTS.md for the project structure and code conventions.

🤝 Contributing

Issues and pull requests are welcome. Before opening a pull request, run the same checks as CI:

dart format lib test
dart analyze --fatal-infos lib test
flutter test

🙏 Acknowledgements

Full third-party notices for the sandbox components are in ios/sandbox/NOTICE and android/app/src/main/jniLibs/NOTICE.

⭐ Star History

Star History Chart

📄 License

Kelivo is licensed under the GNU Affero General Public License v3.0.

kelivo (Chevey339/kelivo)

正在搜索数据库…

4.7K ·GitHub
这是什么?Kelivo 是用 Flutter 构建的开源大语言模型聊天客户端。它可在 Android、iOS、macOS、Windows 和 Linux 上运行,并通过你自己的 API 密钥进行连接。
它是需要安装在设备上的应用,还是需要自己架设的服务器?它是安装在你设备上的应用。它本身没有账号系统,也无需你运行任何服务器。
我该如何让它运行起来?从 GitHub Releases、App Store 或 TestFlight 下载。然后打开设置,进入服务商页面,为预设服务商或你自己的接口端点添加 API 密钥,并获取其模型列表。
我需要 API 密钥或账号吗?你需要来自 OpenAI、Gemini、Claude 或 DeepSeek 等服务商的 API 密钥。或者,你也可以使用 ChatGPT、Grok 或 Kimi Code 账号登录。
让它在我的电脑上执行命令安全吗?请注意:在桌面端,工作区命令会以你的用户账号权限运行,且没有沙盒隔离。对于存放重要文件的文件夹,请保持命令审批开启。
所有功能在每个平台上的表现都一样吗?大多数功能是通用的,但部分功能取决于操作系统。例如,定时任务可在 Android 和桌面端运行,但无法在 iOS 上运行;通过 STDIO 的 MCP 在桌面端原生运行,在移动端则运行于沙盒内。
我能不切换应用就在不同服务商之间切换吗?可以。一个应用即可连接 OpenAI、Gemini、Claude、DeepSeek、OpenRouter 以及任何兼容 OpenAI 的服务,并且可以按模型单独设置推理、工具调用等能力。
我能使用自建或本地模型吗?可以。任何兼容 OpenAI 的接口端点都可以使用,包括自建模型,因此你可以将 Kelivo 指向你自己的服务器。
它有长期记忆功能吗?有。开启自动整理后,后台流程会把值得记住的内容保存为身份类、工作流程类、语音类和指令类记忆,你可以浏览、编辑和归档这些记忆。
它能联网搜索并使用 MCP 工具吗?可以。它支持通过 24 个服务进行联网搜索并附带引用来源,还支持通过 Streamable HTTP、SSE 或 STDIO 连接 MCP 服务器,并可按工具单独审批。
作者
Chevey339
大小
196.8 MB
星标
4.7K
时长
1年
提交 · 90 天