安装指南
系统要求
- 操作系统:macOS(Apple Silicon 或 Intel)或 Linux(x86_64、arm64)
- 磁盘空间:至少 2 GB 可用空间,用于运行时和基础本地模型
- 网络:初次安装和使用云端 Provider 时需要网络连接;模型下载完成后,本地生成可离线运行
安装方式
curl 脚本(推荐)
bash
curl -fsSL https://install.nimi.xyz | sh该脚本会自动检测你的操作系统和架构,下载对应的二进制文件并将其添加到 PATH 中。
npm 全局安装
bash
npm install -g @nimiplatform/nimi需要 Node.js 18 或更高版本。
验证安装
bash
nimi version该命令会输出已安装的 CLI 版本。
运行完整的环境检查:
bash
nimi doctornimi doctor 会报告以下信息:
- CLI 版本
- 配置文件路径
- gRPC 守护进程健康状态
- 运行时模式与进程状态
- 本地引擎状态
- Provider 状态
- 已安装模型数量
启动运行时
后台模式(默认)
bash
nimi start在后台启动运行时守护进程,并将控制权返回给终端。运行时默认在 127.0.0.1:46371 上监听 gRPC 连接。
前台模式
bash
nimi serve在前台启动运行时,日志实时输出到 stdout。适用于调试或实时查看运行时活动。按 Ctrl+C 停止。
验证运行时是否已启动
bash
nimi status确认守护进程是否存活且可连接。
默认端点
运行时暴露的 gRPC 端点为:
127.0.0.1:46371所有 CLI 命令和 SDK 客户端默认连接此端点。
更新 Nimi
curl 脚本
重新运行安装脚本即可。它会用最新版本替换现有的二进制文件:
bash
curl -fsSL https://install.nimi.xyz | shnpm
bash
npm update -g @nimiplatform/nimi更新后,重启运行时以应用更改:
bash
nimi stop
nimi start卸载
curl 脚本安装
从 PATH 中删除二进制文件。默认位置取决于你的系统,安装脚本在安装过程中会输出路径。常见位置:
bash
rm /usr/local/bin/nimi删除配置目录:
bash
rm -rf ~/.niminpm 安装
bash
npm uninstall -g @nimiplatform/nimi删除配置目录:
bash
rm -rf ~/.nimi