Releases: OpenBMB/MiniCPM-Desk-Pet
MiniCPM Desk Pet v0.10.0
MiniCPM Desk Pet v0.10.0 — Release Notes
中文
概述
v0.10.0 带来了全新的仓鼠主题,并在多个平台上进行了稳定性优化。
新特性
- 仓鼠主题 — 全新仓鼠(Hamster)主题,包含完整的待机、工作、拖拽、迷你模式动画。
改进与优化
- 优化了对话结束后桌宠的总结质量,总结内容更加具体、贴合实际对话。
- 优化了推理引擎(sidecar)在各平台上的启动稳定性。
- 改善了 Windows 安装器的兼容性和用户体验。
- 提升了 Windows ARM64 平台的支持完整度。
平台支持
| 平台 | 安装包 | 推理后端 |
|---|---|---|
| macOS(Apple Silicon) | MiniCPM Desk Pet-*-arm64.dmg |
Metal GPU |
| Windows x64 | MiniCPM-Desk-Pet-Setup-*-x64.exe |
CPU / Vulkan GPU |
| Windows ARM64 | MiniCPM-Desk-Pet-Setup-*-arm64.exe |
CPU |
升级说明
- 从旧版本升级时,已有的设置和模型文件会自动保留。
English
Overview
v0.10.0 introduces a brand-new Hamster theme and includes stability improvements across multiple platforms.
New Features
- Hamster theme — A brand-new Hamster theme with complete idle, working, drag, and mini-mode animations.
Improvements
- Improved the quality of post-conversation summaries — the desk pet now provides more specific and relevant narrations.
- Improved inference engine (sidecar) startup stability across platforms.
- Improved Windows installer compatibility and user experience.
- Enhanced support for Windows ARM64 devices.
Platform Support
| Platform | Artifact | Inference Backend |
|---|---|---|
| macOS (Apple Silicon) | MiniCPM Desk Pet-*-arm64.dmg |
Metal GPU |
| Windows x64 | MiniCPM-Desk-Pet-Setup-*-x64.exe |
CPU / Vulkan GPU |
| Windows ARM64 | MiniCPM-Desk-Pet-Setup-*-arm64.exe |
CPU |
Upgrade Notes
- Existing settings and model files are preserved when upgrading from older versions.
MiniCPM Desk Pet v0.7.3
MiniCPM Desk Pet v0.7.3 — Release Notes
中文
概述
v0.7.3 是一次稳定性与发布链路维护版本,重点修复 Windows 启动与 sidecar 生命周期问题,并切换后端到 llama.cpp 主线。
问题修复
- 修复部分环境下 permission bubble 定位时 pet bounds 为空导致的崩溃。
- 修复系统配置 SOCKS/HTTP 代理时 sidecar 继承代理环境变量,可能因缺少
socksio依赖而启动失败的问题。 - 改善 Windows sidecar 退出与 orphan llama-server 清理,降低端口残留导致的后续启动失败概率。
下载
| 平台 | 安装包 |
|---|---|
| macOS(Apple Silicon) | MiniCPM Desk Pet-0.7.3-arm64.dmg |
| Windows x64 | MiniCPM-Desk-Pet-Setup-0.7.3-x64.exe |
| Windows ARM64 | MiniCPM-Desk-Pet-Setup-0.7.3-arm64.exe |
English
Overview
v0.7.3 is a stability and release-pipeline maintenance update focused on fixing Windows startup and sidecar lifecycle issues, while switching the backend to upstream llama.cpp.
Bug Fixes
- Fixed a crash when permission bubble positioning ran before pet window bounds were available.
- Fixed sidecar startup failures caused by inherited SOCKS/HTTP proxy environment variables on systems without
socksio. - Hardened Windows sidecar shutdown and orphaned llama-server cleanup to reduce port-residue startup failures.
Downloads
| Platform | Artifact |
|---|---|
| macOS (Apple Silicon) | MiniCPM Desk Pet-0.7.3-arm64.dmg |
| Windows x64 | MiniCPM-Desk-Pet-Setup-0.7.3-x64.exe |
| Windows ARM64 | MiniCPM-Desk-Pet-Setup-0.7.3-arm64.exe |
MiniCPM Desk Pet v0.7.2
MiniCPM Desk Pet v0.7.2 — Release Notes
中文
概述
v0.7.2 为维护版本,重点提升 sidecar 可靠性、缩小安装包体积,并补充 Windows 安装说明。
问题修复
- Sidecar 启动失败 — 修复部分用户在启动时可能遇到的 sidecar 无法正常启动问题(例如提示「Llama Server is not running」或推理服务一直无法就绪)。
下载
| 平台 | 安装包 |
|---|---|
| macOS(Apple Silicon) | MiniCPM Desk Pet-*-arm64.dmg |
| Windows x64 | MiniCPM-Desk-Pet-Setup-*-x64.exe |
| Windows ARM64 | MiniCPM-Desk-Pet-Setup-*-arm64.exe |
English
Overview
v0.7.2 is a maintenance release focused on sidecar reliability, a smaller install footprint, and clearer Windows installation docs.
Bug Fixes
- Sidecar startup failures — Fixed an issue where some users could not start the sidecar normally on launch (e.g. “Llama Server is not running” or the inference service never becoming ready).
Downloads
| Platform | Artifact |
|---|---|
| macOS (Apple Silicon) | MiniCPM Desk Pet-*-arm64.dmg |
| Windows x64 | MiniCPM-Desk-Pet-Setup-*-x64.exe |
| Windows ARM64 | MiniCPM-Desk-Pet-Setup-*-arm64.exe |
MiniCPM Desk Pet v0.7.1
MiniCPM Desk Pet v0.7.1 — Release Notes
中文
MiniCPM Desk Pet — 首个公开发布
MiniCPM Desk Pet 是一款本地优先的桌面 AI 桌宠。安装后跟随首次启动引导完成设置,即可在桌面上与 MiniCPM 聊天,并在你使用 Cursor、Claude Code、Codex 等 coding agent 时展示不同状态。
主要功能
- 本地对话:模型下载完成后,日常聊天在本地运行,无需远程推理服务
- 零手动配置:首次启动自动完成环境检查、模型下载与预热
- 桌面伙伴:悬浮聊天气泡 + 常驻桌宠,随时对话
- Agent 感知:根据 coding agent 活动展示思考、工作、完成等状态
- 智能模型下载:支持 Hugging Face / ModelScope,自动选择更合适的下载源
- 人格适配器:内置 neko 风格人格,可在 Settings → MiniCPM 中切换或导入
系统要求
| 项目 | 推荐配置 |
|---|---|
| macOS | 14.0+,Apple Silicon (M1/M2/M3/M4),约 2 GB 磁盘空间 |
| Windows | x64,需 Vulkan 支持,约 2 GB 磁盘空间 |
| 网络 | 首次启动需联网下载模型(也可手动选择本地 .gguf 文件) |
安装步骤
macOS
- 下载
MiniCPM Desk Pet-*-arm64.dmg - 打开 DMG,将 MiniCPM Desk Pet 拖入
Applications - 启动应用,按引导完成设置
若 macOS 阻止首次打开,可右键应用选择 打开,或执行:
xattr -cr /Applications/MiniCPM\ Desk\ Pet.appWindows
- 下载
.exe安装程序 - 运行安装向导,按提示完成安装
- 启动应用,按引导完成设置
首次启动
引导流程:环境检查 → 模型下载 → 模型预热 → 开始使用
默认模型:MiniCPM5-1B-GGUF。可自动下载,也可选择已有本地模型文件。
常用快捷键(macOS)
Cmd+Shift+M:打开/关闭聊天气泡Cmd+Shift+T:显示/隐藏思考模式Esc:输入框聚焦时关闭气泡
许可证
本应用以 AGPL-3.0-only 分发。MiniCPM 模型权重单独下载。
English
MiniCPM Desk Pet — First Public Release
MiniCPM Desk Pet is a local-first desktop AI companion. After installation, follow the guided setup to chat with MiniCPM on your desktop and see the pet react to coding activity from tools like Cursor, Claude Code, and Codex.
Highlights
- Local chat — everyday conversations run on your machine after the model is downloaded
- Zero manual setup — first launch guides you through environment check, model download, and warm-up
- Desktop companion — floating chat bubble plus an always-on-screen pet
- Agent-aware reactions — thinking, working, finishing, and idle states based on coding-agent activity
- Smart model download — Hugging Face or ModelScope, with automatic source selection
- Persona adapters — bundled neko-style persona; switch or import adapters in Settings → MiniCPM
System Requirements
| Item | Recommended |
|---|---|
| macOS | 14.0+, Apple Silicon (M1/M2/M3/M4), ~2 GB disk space |
| Windows | x64 with Vulkan support, ~2 GB disk space |
| Network | Internet required on first launch (or provide a local .gguf file) |
macOS Apple Silicon is the primary tested platform. A Windows installer is included — feedback is welcome.
Installation
macOS
- Download
MiniCPM Desk Pet-*-arm64.dmg - Open the DMG and drag MiniCPM Desk Pet into
Applications - Launch the app and follow the setup guide
If macOS blocks the first launch, right-click the app and choose Open, or run:
xattr -cr /Applications/MiniCPM\ Desk\ Pet.appWindows
- Download the
.exeinstaller - Run the installer and complete the wizard
- Launch the app and follow the setup guide
First Launch
Environment Check → Model Download → Model Warm-up → Ready to Use
Default model: MiniCPM5-1B-GGUF. Download automatically or select an existing local model file.
Shortcuts (macOS)
Cmd+Shift+M— open/close chat bubbleCmd+Shift+T— show/hide thinking modeEsc— close bubble when input is focused
License
Distributed under AGPL-3.0-only. MiniCPM model weights are downloaded separately.