工具开源

mink

kevinzakka美国

GitHub 仓库 kevinzakka/mink

类别
框架与工具 · 工具
开放程度
开源
发布时间
2024 年 2 月
开源协议
Apache-2.0
发布方所在地
美国

项目简介

基于 MuJoCo 的 Python 微分逆运动学库,可在构型空间或操作空间定义任务,支持关节位置与速度限制、任意几何体对之间的碰撞规避,以及用等式约束处理闭链机构,刚体变换的李群运算带 C 语言优化。移植自基于 Pinocchio 的 Pink 库,可用 pip 安装。示例覆盖单臂、双臂、臂加灵巧手、人形、四足和移动操作机器人。

mink 安装要点

来源:installation.rst

依据官方资料的 v1.4.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。

  1. 安装 mink

    也可以用 pip install mink

    uv add mink
  2. 验证安装

    pip 安装时去掉 uv run

    uv run python -c "from mink import Configuration; print('OK')"
  3. 运行示例

    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 运行示例

./fix_mjpython_macos.sh
uv run mjpython examples/arm_ur5e.py
来源:README.md
ERROR: Could not find a version that satisfies the requirement mink (from versions: none)

原因Python 版本不够

解决检查 Python 版本,当前文档要求 3.11 及以上

来源:Issue #40
NoSolutionFound

原因硬约束下问题没有可行解

解决把约束包进 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

星标、下载量等指标定期自动更新。

mink:安装步骤、环境要求与常见报错 | 具身集