- 类别
- 框架与工具 · 工具
- 开放程度
- 开源
- 发布时间
- 2024 年 2 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 美国
项目简介
基于 MuJoCo 的 Python 微分逆运动学库,可在构型空间或操作空间定义任务,支持关节位置与速度限制、任意几何体对之间的碰撞规避,以及用等式约束处理闭链机构,刚体变换的李群运算带 C 语言优化。移植自基于 Pinocchio 的 Pink 库,可用 pip 安装。示例覆盖单臂、双臂、臂加灵巧手、人形、四足和移动操作机器人。
mink 安装要点
来源:installation.rst依据官方资料的 v1.4.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装 mink
也可以用 pip install mink
uv add mink验证安装
pip 安装时去掉 uv run
uv run python -c "from mink import Configuration; print('OK')"运行示例
macOS 的运行方式见下面的 mjpython 报错
git clone https://github.com/kevinzakka/mink.git && cd mink uv sync uv run examples/arm_ur5e.py
环境要求
来源:pyproject.toml- Python
- 3.11 及以上
- MuJoCo
- 3.10.0 及以上
- QP 求解器
- qpsolvers[daqp] 4.12.0 及以上
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
`launch_passive` requires that the Python script be run under `mjpython` on macOS原因macOS 上要用 mjpython 运行带查看器的脚本
解决先运行一次 fix_mjpython_macos.sh,再用 mjpython 运行示例
来源:README.md./fix_mjpython_macos.sh uv run mjpython examples/arm_ur5e.pyERROR: Could not find a version that satisfies the requirement mink (from versions: none)原因Python 版本不够
解决检查 Python 版本,当前文档要求 3.11 及以上
来源:Issue #40NoSolutionFound原因硬约束下问题没有可行解
解决把约束包进 Elastic,用 L1 惩罚代替等式,问题就保持可行
来源:README.md
适配机器人
- Franka Panda
- UR5e
- KUKA iiwa14
- ALOHA 2
- Shadow Hand
- Unitree G1
- Boston Dynamics Spot
- Hello Robot Stretch
获取方式
同类项目
开发工具数据来源
本页信息均整理自以下公开资料。
5 条来源核验于 2026-10-01