安装指南
极速开发阶段
Nimi 目前仍处于极速开发阶段。安装与上手流程已经可用，但合约、默认行为和 CLI 细节仍可能在版本之间快速变化。
下载桌面应用
桌面应用是开始使用 Nimi 的最快方式。
| 平台 | 状态 |
|---|---|
| macOS (Apple Silicon) | 已发布在 GitHub Releases — 更新归档（.app.tar.gz） |
| macOS (Intel) | 已发布在 GitHub Releases — 更新归档（.app.tar.gz） |
| Windows | 已发布在 GitHub Releases — NSIS 安装器（.exe） |
| Linux | 已发布在 GitHub Releases — AppImage |
如果你偏好命令行或希望自动化安装，请使用下方的 CLI 安装方式。curl 安装器支持 macOS 和 Linux；npm install -g @nimiplatform/nimi 覆盖受支持的 macOS、Linux 和 Windows 目标平台。 如果某个 macOS 桌面版本以 ad-hoc 签名模式发布，Gatekeeper 可能会要求你在首次启动前手动放行解压后的应用。
系统要求
- 通过
curl安装 CLI：macOS 或 Linux（x86_64、arm64） - 通过 npm 安装 CLI：受支持的 macOS、Linux 和 Windows 平台，且需要 Node.js 18 或更高版本
- 桌面应用：macOS（Apple Silicon 或 Intel）、Windows 或 Linux
- 磁盘空间：至少 2 GB 可用空间，用于运行时和基础本地模型
- 网络：初次安装和使用云端 Provider 时需要网络连接；模型下载完成后，本地生成可离线运行
安装方式
curl 脚本（推荐）
curl -fsSL https://install.nimi.xyz | sh该脚本会自动检测你的操作系统和架构，下载对应的二进制文件并将其添加到 PATH 中。 默认会把 nimi 安装到 ~/.nimi/bin/nimi，并在需要时把 ~/.nimi/bin 追加到 ~/.zshrc、~/.bashrc 和 ~/.profile。
npm 全局安装
npm install -g @nimiplatform/nimi需要 Node.js 18 或更高版本。
验证安装
nimi version该命令会输出已安装的 CLI 版本。
运行完整的环境检查：
nimi doctornimi doctor 会报告以下信息：
- CLI 版本
- 配置文件路径
- gRPC 守护进程健康状态
- 运行时模式与进程状态
- 本地引擎状态
- Provider 状态
- 已安装模型数量
启动运行时
后台模式（默认）
nimi start在后台启动运行时守护进程，并将控制权返回给终端。运行时默认在 127.0.0.1:46371 上监听 gRPC 连接。
前台模式
nimi serve在前台启动运行时，日志实时输出到 stdout。适用于调试或实时查看运行时活动。按 Ctrl+C 停止。
验证运行时是否已启动
nimi status确认守护进程是否存活且可连接。
默认端点
运行时暴露的 gRPC 端点为：
127.0.0.1:46371所有 CLI 命令和 SDK 客户端默认连接此端点。
更新 Nimi
curl 脚本
重新运行安装脚本即可。它会用最新版本替换现有的二进制文件：
curl -fsSL https://install.nimi.xyz | shnpm
npm update -g @nimiplatform/nimi更新后，重启运行时以应用更改：
nimi stop
nimi start卸载
curl 脚本安装
从安装目录中删除二进制文件。默认位置为：
rm -f ~/.nimi/bin/nimi如果你不再希望 shell PATH 包含 ~/.nimi/bin，请同时从 ~/.zshrc、~/.bashrc 或 ~/.profile 中删除安装脚本写入的 PATH 行。
删除配置目录：
rm -rf ~/.niminpm 安装
npm uninstall -g @nimiplatform/nimi删除配置目录：
rm -rf ~/.nimi