mink

20개 이상의 로봇 플랫폼을 지원하는 MuJoCo 기반 Python 역기구학 라이브러리

라이선스

Apache-2.0

개요

mink(MuJoCo Inverse Kinematics)는 MuJoCo 위에 구축된 미분 역기구학을 위한 Python 라이브러리입니다. 문제를 이차 프로그램(QP)으로 공식화하여 물리적 제약 조건을 존중하면서 작업 공간 목표를 만족시키는 관절 속도를 계산하는 로봇공학의 핵심 문제를 해결합니다.

라이브러리는 단일 해결 단계에서 엔드 이펙터 포즈 추적, 상대 프레임 추적, 자세 조절, 무게 중심 제어, 관절 댐핑, 자유도 고정 등의 여러 목표를 결합할 수 있는 구성 가능한 작업 추상화를 제공합니다. 관절 위치 한계, 속도 한계, 모든 기하학적 쌍 간의 충돌 회피를 포함한 물리적 제약 조건이 자동으로 적용됩니다.

mink는 단일 및 듀얼 암(Franka Panda, UR5e, KUKA iiwa14, ALOHA 2), 암-핸드 조합(iiwa14+Allegro, xArm+LEAP), 정교한 손(Shadow Hand), 휴머노이드(Unitree G1, H1, Apptronik Apollo), 사족보행 로봇(Unitree Go1, Boston Dynamics Spot), 이족 보행(Agility Cassie), 모바일 매니퓰레이터(Stanford TidyBot, Hello Robot Stretch)를 포함한 광범위한 로봇 플랫폼을 지원합니다.

UC Berkeley 박사 과정 학생이자 Google PhD Fellow인 Kevin Zakka가 Pink 라이브러리(Pinocchio 기반)를 MuJoCo로 포팅한 것입니다. 버전 1.0.0은 2025년 12월에 안정적인 릴리스에 도달했습니다.

mink (MuJoCo Inverse Kinematics)는 MuJoCo 생태계에 제품 수준의 미분 역기구학(differential inverse kinematics)을 제공하는 Python 라이브러리입니다. UC Berkeley 박사과정 학생이자 Google PhD Fellow인 Kevin Zakka가 개발한 이 라이브러리는 중요한 공백을 채웁니다 — MuJoCo가 로봇공학 연구의 사실상 표준 시뮬레이터가 되었지만, 제약 조건 처리와 충돌 회피 기능을 갖춘 네이티브 역기구학 솔버가 부족했습니다.

이 라이브러리는 역기구학을 이차 계획법(quadratic program, QP)으로 정식화하여 수학적으로 깔끔하고 계산적으로 효율적인 접근 방식을 제공합니다. 엔드 이펙터 추적, 상대 프레임 제어, 자세 조절, 질량 중심 위치 결정, 관절 감쇠 등 다양한 작업 공간 목표를 동시에 구성하고 풀 수 있습니다. 관절 위치 제한, 속도 제한, 임의의 기하학 쌍 간의 충돌 회피와 같은 물리적 제약 조건이 자동으로 적용됩니다.

mink는 단일 및 이중 로봇 팔(Franka Panda, UR5e, KUKA iiwa14, ALOHA 2), 팔-손 조합(iiwa14+Allegro, xArm+LEAP), 정교한 로봇 손(Shadow Hand), 휴머노이드(Unitree G1, H1, Apptronik Apollo), 사족 보행 로봇(Unitree Go1, Boston Dynamics Spot), 이족 보행 로봇(Agility Cassie), 모바일 매니퓰레이터(Stanford TidyBot, Hello Robot Stretch) 등 20개 이상의 로봇 플랫폼을 기본 지원합니다.

mink는 원래 Pinocchio 위에 구축된 Pink 라이브러리를 MuJoCo로 포팅한 것으로, MuJoCo의 빠른 충돌 감지와 daqp QP 솔버를 활용합니다. 버전 1.0.0은 2025년 12월에 안정 릴리스에 도달하여 프로덕션 로봇공학 애플리케이션에 대한 준비를 완료했습니다.

중요한 이유

mink는 충돌 회피와 제약 처리를 갖춘 깔끔하고 잘 설계된 역기구학 라이브러리를 제공함으로써 MuJoCo 생태계의 중요한 격차를 채웁니다. MuJoCo가 로봇공학 연구의 사실상 표준 시뮬레이터가 됨에 따라, MuJoCo에 기본적으로 구축된 프로덕션 품질의 IK 라이브러리를 갖추는 것이 로봇공학 소프트웨어 스택을 크게 단순화합니다.

해결하는 문제

충돌 회피, 관절 한계, 여러 작업 공간 목표를 동시에 처리하는 MuJoCo용 네이티브 프로덕션 품질 역기구학 라이브러리의 부재

핵심 요점

• 실시간 성능을 갖춘 이차 프로그래밍으로 공식화된 미분 IK
• 단일 암에서 휴머노이드 및 사족보행 로봇까지 20개 이상의 로봇 플랫폼 지원
• 모든 기하학적 쌍 간의 내장 충돌 회피
• 단일 해결 단계에서 여러 목표를 결합하기 위한 구성 가능한 작업 추상화

대상

• MuJoCo를 사용하는 로보틱스 연구자
• 로봇 조작 개발자
• 휴머노이드 제어 연구자
• 모션 계획 엔지니어

한계

• MuJoCo 특화 - 다른 물리 엔진과 함께 사용 불가
• 미분 IK는 로컬 솔버 - 대규모 동작에 대한 로컬 최솟값에 갇힐 수 있음
• QP 솔버 의존성(daqp)이 매우 높은 DOF 시스템에서 제한이 있을 수 있음
• Python 전용 - 실시간 임베디드 애플리케이션을 위한 C++ 바인딩 없음