# MiniCPM-Robot **Repository Path**: limoncc/MiniCPM-Robot ## Basic Information - **Project Name**: MiniCPM-Robot - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-20 - **Last Updated**: 2026-07-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

MiniCPM-Robot

更聪明、更快速的机器人端侧 AI 大脑

English · 中文

[![Github](https://img.shields.io/badge/MiniCPM--Robot-000000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/OpenBMB/MiniCPM-Robot) [![Hugging Face Collection](https://img.shields.io/badge/Models-fcd022?style=for-the-badge&logo=huggingface&logoColor=000)](https://huggingface.co/collections/openbmb/minicpm-robot) [![Cookbook](https://img.shields.io/badge/%F0%9F%8D%B3_cookbook-ff69b4?style=for-the-badge)](#quick-start) [![Lark](https://img.shields.io/badge/Lark-00D6B9?style=for-the-badge&logo=data:image/png;base64,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)](assets/feishu_group.png)
**MiniCPM-Robot** 是 MiniCPM 面向真实世界感知、决策与行动的具身智能模型系列。首批模型包括: - **MiniCPM-RobotManip**:🦾 **1.5B** 通用机器人操作 VLA(仿真与真机)。一套权重覆盖下游任务,代表性评测中超过 π₀.₅ (3B)、 Qwen-VLA (5B+) 等更大模型。流式推理保留原生记忆能力,并且维持了和以前一样的响应速度。 - **MiniCPM-RobotTrack**:🎯 **首个纯端侧**具身目标跟踪方案(**0.9B**)。覆盖静态、动态与对抗目标,**EVT-Bench 开源 SOTA**;在 Unitree Go2 EDU 上可达 **5+ FPS / 约 180 ms**,纯视觉、纯本地自然语言跟踪。

MiniCPM-RobotManip 任务演示

## 🎉 最新动态 * [2026.07.19] 🔥🔥🔥 我们正式发布并开源了 MiniCPM-Robot,这是 MiniCPM 首个面向物理世界交互的具身智能模型系列。首批发布 [MiniCPM-RobotManip](https://huggingface.co/openbmb/MiniCPM-RobotManip) 与 [MiniCPM-RobotTrack](https://huggingface.co/openbmb/MiniCPM-RobotTrack),分别面向通用机器人操作和具身目标跟踪。欢迎试用! * [2026.07.19] 🚀🚀🚀 [PhyAI](https://github.com/MEmbodied/phyai) 已实现对 MiniCPM-Robot 的 Day-0 支持,通过 CUDA Graph 和 Triton 定制融合算子,将 NVIDIA H20 上的推理帧率从 10 Hz 提升至 37 Hz。 ## 目录 - [MiniCPM-RobotManip](#minicpm-robotmanip) - [榜单结果](#榜单结果) - [快速开始](#快速开始) - [推理](#推理) - [MiniCPM-RobotTrack](#minicpm-robottrack) - [榜单结果](#evt-bench-结果) - [快速开始](#快速开始-1) - [Cookbook](#数据准备) - [模型仓库](#模型仓库) ## MiniCPM-RobotManip MiniCPM-RobotManip 是面向具身操作的 1.5B 视觉-语言-动作模型,主要亮点如下: ### 榜单结果
方法 评测设置 开源权重 参数规模 (VL+A) LIBERO Calvin (ABC→D) RoboTwin2 (clean+random) RMBench
easyhard
π₀Specialist3B94.43.965.958.4
π₀.₅Specialist3B96.94.182.776.810.4
Abot-M0Specialist4B+98.686.185.1
StarVLA-αGeneralist4B+97.888.787.8
Qwen-VLAGeneralist5B+97.986.187.2
LingBot-VASpecialist5B+98.592.991.6
MiniCPM-RobotManipGeneralist1.5B97.54.191.391.653.3
### 快速开始

请先安装并初始化 Conda。环境配置基于已验证的 Python 3.10 和 PyTorch 2.6.0(CUDA 12.4)。

cd MiniCPM-RobotManip
conda env create -f environment.yml
conda activate MiniCPM-RobotManip
### 推理

使用 vla_infer.py 进行单样本推理。至少提供一张图像和一条语言指令;若未提供机器人状态,则默认使用全零向量。模型输出动作序列,形状为 (30, 80)

cd MiniCPM-RobotManip
python vla_infer.py \
    --image frame.jpg \
    --text "Pick up the red block." \
    --checkpoint ./checkpoint \
    --state-file state.npy \
    --embodiment-id 0 \
    --output action.npy

多视角输入可重复使用 --image。未指定 --output 时,预测动作将以 JSON 打印。

cd MiniCPM-RobotManip
python vla_infer.py \
    --image cam_front.jpg \
    --image cam_wrist.jpg \
    --text "Pick up the red block." \
    --checkpoint ./checkpoint
## MiniCPM-RobotTrack MiniCPM-RobotTrack 是基于 MiniCPM4-0.5B 的轻量视觉-语言-动作策略,面向具身目标跟踪,主要亮点如下: ### 示例
户外障碍场景目标跟踪 Demo 电梯场景目标跟踪 Demo 地下车库目标跟踪 Demo
户外障碍追踪 电梯场景追踪 地下车库追踪
### EVT-Bench 结果

指标顺序为 SR / TR / CR:成功率与跟踪率越高越好,碰撞率越低越好;表中数值均为百分比。

方法 开源权重 参数规模 (VL+A) STT DT AT
SR ↑TR ↑CR ↓ SR ↑TR ↑CR ↓ SR ↑TR ↑CR ↓
TrackVLA 7.8B+ 85.178.61.7 57.663.25.8 50.263.717.1
TrackVLA++ 7.8B+ 86.081.02.1 66.568.84.7 51.263.415.9
Qwen-RobotNav 4.4B+ 77.490.06.4
OmTrackVLA 1.0B+ 81.482.85.1 41.558.811.3 60.073.97.6
MiniCPM-RobotTrack 0.9B 84.189.83.0 53.273.413.6 58.080.49.0

在表中列出的开源 checkpoint 里,MiniCPM-RobotTrack 获得 STT 的最佳 SR/TR/CR 和 DT 的最佳 SR/TR,并以 0.5B 骨干在 AT 上取得 80.35 TR

### 快速开始 #### 1. 配置环境

请先安装并初始化 Conda。环境配置基于已验证的 Python 3.9、Habitat-Sim 0.3.1、Bullet、PyTorch 2.4.1 和 CUDA 12.1。

cd MiniCPM-RobotTrack
conda env create -f environment.yml
conda activate MiniCPM-RobotTrack
#### 2. 准备仿真数据与资产

按照 Habitat-Sim 数据说明TrackVLA 资产说明 下载 HM3D、MP3D、人物与机器人资产,并保持其在项目 data/ 下的原始目录结构。

data/
├── datasets/
├── scene_datasets/
├── humanoids/
└── robots/
### 数据准备 #### 1. 未处理的 rollout

每个 Habitat rollout 保留视频、逐步状态和 episode 结果。仓库中的 sim_data/raw_sample 提供了一个可运行的原始样例,其中逐步状态格式如下:

{
  "base_velocity": [0.62, 0.00, 0.02],
  "collision": false,
  "target_distance": 1.72,
  "human_center_norm": [0.50, 0.48]
}
#### 2. 生成 trajectory 数据

下面的命令会筛选成功 episode、抽取 RGB 帧,并根据未来动作生成用于微调的 trajectory JSONL:

cd MiniCPM-RobotTrack
python tools/make_tracking_data.py \
  --input_root sim_data/raw_sample \
  --output_root sim_data/train/stt \
  --only_success \
  --history 31 \
  --horizon 8 \
  --dt 0.1 \
  --incremental

处理完整数据时,将 STT、DT、AT 的原始 rollout 分别写入 sim_data/raw/<task>,并为每个任务执行同一命令。

#### 3. 预缓存视觉特征
cd MiniCPM-RobotTrack
for task in stt dt at; do
  python tools/precompute_features.py \
    --json "sim_data/train/${task}/jsonl" \
    --data-root "sim_data/train/${task}" \
    --cache-root "sim_data/train/${task}/vision_cache"
done

处理结果包含 frames/jsonl/vision_cache/sim_data/sample 提供 STT、DT、AT 各两条已处理记录,可直接查看最终训练数据格式。

### 微调

准备三个任务的数据与视觉缓存后,运行公开的 finetune 入口:

cd MiniCPM-RobotTrack
bash scripts/train.sh

数据路径、batch size、学习率与训练轮数均可在 scripts/train.sh 中调整。

### 模型测评

将完整的 Hugging Face snapshot 下载到 minicpm_robot_track/checkpoints/MiniCPM-RobotTrack/。该 snapshot 已包含 微调后的 MiniCPM4 backbone,并通过 Transformers from_pretrained 加载。 测评仍需要 DINOv3 ViT-S/16 和 SigLIP So400m;可以通过环境变量指定已经下载的 视觉模型目录:

export DINOV3_MODEL_PATH=/path/to/dinov3-vits16
export SIGLIP_MODEL_PATH=/path/to/siglip-so400m-patch14-384

环境、模型和仿真资产准备完成后,分别执行三个任务的测评脚本:

cd MiniCPM-RobotTrack
CKPT=minicpm_robot_track/checkpoints/MiniCPM-RobotTrack
bash scripts/eval_stt.sh "$CKPT" results/stt
bash scripts/eval_dt.sh  "$CKPT" results/dt
bash scripts/eval_at.sh  "$CKPT" results/at

每条命令会完成对应任务测评。

### Go2 实机部署

实机流程面向配备 Jetson Orin NX 16GB 的 Unitree Go2 EDU。已验证环境为 Jetson Linux R36.5、CUDA 12.6、TensorRT 10.7、Python 3.10、ROS 2 Humble 和 MAXN mode 0。部署使用独立的 Jetson 依赖,并默认运行在不会下发运动命令的 dry-run 模式。

Go2/D435i RGB -> TCP JPEG -> DINO + SigLIP TensorRT
              -> MiniCPM-RobotTrack -> waypoint -> 限速控制

完整配置包括 Go2 EDU、Orin NX 16GB 和 D435i。仓库默认并已实机验证的是 Go2 前置相机,每套新设备仍须单独验证 D435i RGB 链路。详细硬件参数、网络配置、 资产下载、刷机方法和实控流程统一放在部署文档中:

#### 快速开始

下面假设 JetPack 6 和载板补丁已经完成:

使用者需要自行从 openbmb/MiniCPM-RobotTrack 下载完整的 Hugging Face snapshot,并将其中的自定义模型代码、tokenizer 文件和 model.safetensors 放到 MiniCPM-RobotTrack/minicpm_robot_track/checkpoints/MiniCPM-RobotTrack/, 再运行预检。

cd MiniCPM-RobotTrack

python3 scripts/download_upstream_assets.py

python3 -m pip install --user -r requirements-build.txt
./scripts/export_onnx.sh

sudo nvpmodel -m 0
sudo jetson_clocks
./scripts/build_engines.sh

./scripts/preflight.sh
./go2_runtime.py run

状态与停止:

cd MiniCPM-RobotTrack
./go2_runtime.py status
./go2_runtime.py stop-control
./go2_runtime.py stop
> **安全提示:**首次运行必须保留 `runtime.mode: dry-run`。启用实控前,应在支架上 > 完成相机、模型、时延和停车链路验证,并确保现场有人且遥控器/App 急停可用。 > 完整实控步骤与限速要求见 [Go2 部署指南](MiniCPM-RobotTrack/docs/GO2_DEPLOYMENT_zh-CN.md)。 ## 模型仓库 | 模型 | 简介 | 下载 | | --- | --- | --- | | MiniCPM-RobotManip | 面向机器人操作(Robot Manipulation)的 1.5B 视觉-语言-动作模型 | [🤗](https://huggingface.co/openbmb/MiniCPM-RobotManip) | | MiniCPM-RobotTrack | 面向目标跟踪(Target Tracking)的 0.9B 视觉-语言-动作模型 | [🤗](https://huggingface.co/openbmb/MiniCPM-RobotTrack) | ## 许可证 模型权重与代码均基于 [Apache-2.0](./LICENSE) 许可证开源。 ## 致谢

MiniCPM-Robot 的开发参考并基于 MiniCPM、 starVLALeRobot、 DINOv3、SigLIP、Habitat-Lab、Habitat-Sim、EVT-Bench 和 TrackVLA。 感谢相关作者与社区的开源贡献。 第三方模型、仿真代码、数据集与资产继续遵循各自许可,详见 THIRD_PARTY_NOTICES.md