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 — клиент для языковых моделей (LLM) с открытым исходным кодом, созданный на Flutter. Работает на Android, iOS, macOS, Windows и Linux, и вы подключаете его к своим собственным API-ключам.
Это приложение, которое я устанавливаю, или сервер, который мне нужно развернуть?Это приложение, которое устанавливается на ваши устройства. Собственной системы учётных записей у него нет, и запускать сервер не нужно.
Как его запустить?Скачайте его со страницы GitHub Releases, из App Store или TestFlight. Затем откройте Settings, перейдите в Providers, добавьте API-ключ для одного из готовых провайдеров или для своего эндпоинта и загрузите его список моделей.
Нужен ли мне API-ключ или аккаунт?Нужен собственный API-ключ от провайдера, например OpenAI, Gemini, Claude или DeepSeek. Кроме того, можно войти с аккаунтом ChatGPT, Grok или Kimi Code.
Безопасно ли разрешать ему запускать команды на моём компьютере?Будьте осторожны: на компьютере команды в рабочем пространстве выполняются с правами вашей учётной записи и не изолированы в песочнице. Для папок с важными файлами оставьте включённым подтверждение команд.
Одинаково ли работают все функции на всех платформах?Большинство функций общие, но некоторые зависят от операционной системы. Например, запланированные задачи работают на Android и на компьютерах, но не на iOS, а MCP через STDIO на компьютерах работает напрямую, а на мобильных устройствах — внутри песочницы.
Можно ли переключаться между провайдерами, не меняя приложение?Да. Одно приложение подключает OpenAI, Gemini, Claude, DeepSeek, OpenRouter и любой сервис, совместимый с OpenAI, а такие возможности, как рассуждения и использование инструментов, можно настраивать для каждой модели отдельно.
Можно ли использовать свои или локальные модели?Да. Работает любой эндпоинт, совместимый с OpenAI, включая модели на собственном сервере, так что Kelivo можно направить на ваш сервер.
Есть ли долговременная память?Да. Если включена автоматическая систематизация, фоновый процесс сохраняет то, что стоит запомнить, в виде воспоминаний о личности, порядке работы, манере общения и инструкциях. Их можно просматривать, редактировать и архивировать.
Может ли он искать в интернете и использовать инструменты MCP?Да. Поддерживается веб-поиск через 24 сервиса со ссылками на источники, а также серверы MCP по Streamable HTTP, SSE или STDIO с подтверждением для каждого инструмента.
Автор
Chevey339
Размер
196.8 MB
Звёзды
4.7K
Возраст
1 г
Коммиты · 90 дней