프로젝트 하이라이트: 11월 9일~15일
- 출처: Open Source Robotics
- 게시일: 2026-11-16
- 카테고리: upstream
mjlab 새 설치가 MuJoCo를 망가뜨렸고, MuJoCo 4.0.1이 4.0.0의 솔버 버그를 고쳤으며, Rerun 0.43과 Strands Robots 0.6.0은 기존 코드를 깨뜨리고, uni-robot-agent는 프로토콜을 바꿨습니다.
mjlab
!mjlab
- 버전 1.6.1은 새로 설치하면 MuJoCo가 망가지던 문제를 고칩니다. 뷰어 패키지 mjviser의 새 버전(0.0.17)이 mujoco 대신 mujoco-core에 의존하게 되어, pip와 uv가 고정된 mujoco 3.11 옆에 mujoco-core 4.0.1을 설치했고, 둘 다 같은 mujoco/ 폴더에 썼습니다. - 이전 mjlab 버전은 의존성에 "mjviser<0.0.17"을 추가하면 해결됩니다. 1.6.1도 같은 상한을 둡니다. 릴리스 노트 - 왜 중요한가: 이번 주에 mjlab 환경을 설치하거나 다시 만들었는데 MuJoCo가 이상하게 동작하거나 import되지 않는다면, 원인은 코드가 아니라 이 충돌입니다. 상한을 추가하거나 1.6.1로 옮긴 뒤 깨끗한 환경에 다시 설치하세요.
MuJoCo
!MuJoCo
- 버전 4.0.1은 4.0.0에서 생긴 희소 숄레스키 분해의 버그를 고칩니다. 제약 야코비안이 희소할 때 뉴턴 솔버에 잘못된 헤시안 인자가 전달되어, 느린 수렴, 잘못된 가속도, 발산으로 나타났습니다. - 4.0.0의 macOS와 Linux 아카이브에서는 로드에 실패하는 동적 라이브러리(USD 디코더 플러그인) 하나 때문에 simulate가 시작 시 중단되었습니다. 이제는 경고를 내고 건너뜁니다. 릴리스 노트 - 왜 중요한가: MuJoCo 4.0.0에서 모델을 돌렸고 솔버가 발산하거나 가속도가 이상해 보였다면, 4.0.1로 업데이트해서 다시 돌린 뒤에 그 결과를 믿거나 학습에 쓰세요.
Rerun
!Rerun
- JavaScript에서 웹 뷰어를 포함하거나 Rerun Hub에서 저장소를 설정하는 코드는 0.43에서 깨집니다. JavaScript API는 이제 camelCase를 쓰고, object_store_config는 storage_location으로 이름이 바뀌었습니다(Python과 Rust에서는 StorageLocationAlias). 버전 0.43.1은 웹 뷰어의 snake_case 옵션을 다시 받아들입니다. - 0.43의 새 기능: 뷰어에서 그리드 맵과 볼륨의 이동값, 그리고 복셀 크기를 편집할 수 있습니다. 메모리 제한이 이제 Linux cgroup 제한을 따릅니다. 0.43.2는 Safari에서 점과 깊이 클라우드가 그려지지 않던 문제를 고칩니다. 릴리스 노트 - 왜 중요한가: JavaScript에서 Rerun 웹 뷰어를 포함하거나 Rerun Hub 저장소를 설정한다면 0.43.1 이상을 쓰고 마이그레이션 가이드를 따르세요. 컨테이너에서 Rerun을 실행한다면 RAM 제한이 이제 머신 전체가 아니라 컨테이너의 제한을 따릅니다.
Strands Robots
!Strands Robots
- 버전 0.6.0은 세 개의 클래스를 중심으로 다시 쓴 것입니다. Simulation(MuJoCo 또는 GPU 엔진 위의 세계), Robot, Policy. 같은 코드로 시뮬레이션 로봇, 실제 로봇, 다른 머신의 로봇을 모두 구동하며, 76개의 로봇 프리셋을 이름으로 불러올 수 있습니다. - 0.5.x API는 제거되었습니다. 에이전트가 보낸 범위를 벗어난 명령은 이제 잘라내지 않고 오류와 함께 거부됩니다. 릴리스 노트 - 왜 중요한가: Strands Robots 0.5.x용으로 코드를 작성했다면 옮기기 전에는 0.6.0에서 실행되지 않으므로 그때까지 0.5.x에 고정하세요. 에이전트가 로봇을 구동한다면, 전에는 조용히 잘라내던 곳에서 거부가 나올 것입니다.
uni-robot-agent
!uni-robot-agent
- 버전 0.2.0은 네 가지 도구(move, hold, capture_scene, finish)로 이루어진 '클린 모드', 관측 기록에서 오래된 인라인 이미지를 없애는 선택형 창, 오프라인 doctor 명령, ARX ONE의 실제 로봇 통합을 추가합니다. - 환경 프로토콜 4, 도구 스키마 8, 액터 HTTP 프로토콜 v3으로 옮겨 가며, 이전 서비스와는 호환되지 않습니다. 네이티브 환경에는 uni-robot-agent-runtime 0.2.0을 따로 설치해야 하고, 두 패키지를 같은 Python 환경에 두면 안 됩니다. 릴리스 노트 - 왜 중요한가: uni-robot-agent의 클라이언트와 환경 서비스를 서로 다른 머신에서 실행한다면 함께 업그레이드하지 않으면 서로 통신하지 못합니다. 두 패키지를 같은 환경에 설치하면 그 환경이 망가집니다.
AI Worker
!AI Worker
- 버전 2.3.3은 설정 가능한 하트비트 타임아웃으로 리더 암의 연결 끊김을 감지하고, 기본 방식의 원격 조종이 멈추면 제어를 외부 제어에 돌려주며, 원격 조종을 시작하기 전에 초기 자세가 끝나기를 기다리고, 관절 모드와 엔드 이펙터 모드 모두에서 그리퍼 동작을 게시합니다. 릴리스 노트 - 2.3.3 이후 메인 브랜치에서 로봇 F1과 F2가 W1과 W2로 이름이 바뀌었습니다. 실행 파일, 설정 폴더, MoveIt의 model:= 인수(w1, w2)가 모두 바뀝니다. 변경 내용 - 왜 중요한가: AI Worker를 원격 조종한다면 이제 연결이 끊긴 리더 암이 설정 가능한 타임아웃으로 감지됩니다. 그리고 f1이나 f2를 쓰는 스크립트나 실행 명령은 이름 변경이 포함된 버전으로 옮기는 순간 실패합니다.
Microduck
!Microduck
- 버전 0.21.0에서는 NFC 태그를 로봇의 머리에 대면 모드가 바뀝니다. 걷기, 롤러스케이트, 레이저 따라가기, 축구, 그리고 오리가 돌아다니고, 낮잠을 자고, 레이저 점을 쫓고, 공을 가지고 놀고, 방의 지도를 만드는 자율 모드입니다. 태그는 robotctl nfc-flash로 씁니다. - 버전 0.21.1은 네트워크로 로봇에 들어가는 방법을 추가합니다. 얼굴 버튼을 5초간 누르고 있으면 wifi로 SSH가 30분 동안 열립니다. 프로토콜은 API 55에서 61로 바뀌며 모두 추가 변경입니다. 릴리스 노트 - 왜 중요한가: 로봇의 모든 데몬을 함께 업데이트하세요. v59 robotd는 새로운 hello {client}와 robot.head {alpha} 호출을 이름으로 거부합니다. 또한 관리자들은 0.21.0과 0.21.1을 CI에서만 확인하고 실제 로봇에서는 실행하지 않은 채 곧바로 배포했으므로, 먼저 작업대에서 시험해 보세요.
ORCA Hand
!ORCA Hand
- Orca Core 0.13.0은 v2.1 핸드용 가이드 텐셔닝(scripts/guided_tension.py)을 추가합니다. 각 관절을 가동 범위 전체로 움직이는 동안 모터는 가볍게 잡고 있고, 스크립트가 각 힘줄이 얼마나 팽팽한지 점수를 매긴 뒤, 모자라는 힘줄을 래칫으로 조이는 동안 모터가 붙잡아 줍니다. v2.0 핸드는 계속 scripts/tension.py를 씁니다. - 또한 각 관절을 손으로 끝 지점까지 움직이는 수동 캘리브레이션, 세 자리로 보고되는 하드웨어 버전(v2.1.0은 210), 촉각 센서 수정이 추가되었습니다. 이전에는 프로그램이 바쁘면 다시 연결될 때까지 촉각을 잃을 수 있었습니다. 변경 내용 - 왜 중요한가: v2.1 핸드를 만든다면 가이드 스크립트로 장력을 잡고 캘리브레이션은 마지막에 하세요. 모터가 붙잡고 있는 동안 손가락을 세게 밀면 힘줄이 느슨해질 수 있으니 피하세요. 캘리브레이션 기록은 이제 불러온 설정 옆에 저장되므로, 같은 모델의 핸드가 둘 이상이면 각각에 별도의 설정 사본을 주세요.
SO-ARM 102
!SO-ARM 102
- 조립 가이드는 이제 소책자 v0.8을 따르며 각 관절의 서보를 명시합니다. 리더의 서보는 모두 STS3215이고, 팔로워에서는 ID 1과 4가 Feetech STS3235, ID 2와 3이 STS3250입니다. - 단계에서 '서보 키트'로 표시된 나사는 낱개 체결구 봉지가 아니라 서보 패키지에 들어 있는 것입니다. 보드 홀더와 캡의 번호는 SO102.02.101로 바뀌었고, 카메라 홀더 단계에는 M3×10 나사가 4개가 아니라 5개 필요합니다. 변경 내용 - 왜 중요한가: SO-ARM 102 팔로워용 서보를 사거나 부품을 출력한다면, 주문 전에 각 ID의 서보 모델을 v0.8 가이드와 대조하고, v0.7이 아니라 v0.8 소책자를 출력하세요. 부품 번호와 나사 수가 다릅니다.
pib
!pib
- 버전 0.7.12는 imitate_hands를 올바른 방향으로 되돌립니다. 오른쪽 아래팔 회전의 부호가 다시 반전되었고 손 추적의 자르기도 수정되었습니다. - 버전 0.7.14는 pib의 설치와 업데이트 방식을 바꿉니다. setup-pib.sh는 이제 브랜치 대신 가장 최신 릴리스 태그를 체크아웃하고, 업데이트는 레지스트리에서 미리 빌드된 이미지를 받아오며(로컬 빌드는 대체 수단), 업데이트가 git을 건드리기 전에 남은 디스크 공간을 확인합니다. 버전 0.7.17은 카메라의 스테레오 깊이를 기본으로 끕니다. 릴리스 노트 - 왜 중요한가: 사람의 팔 움직임을 따라 하는 pib는 0.7.12 전까지 오른팔을 반대 방향으로 움직였으므로, 시연 전에 업데이트하세요. 0.7.17로 옮긴 뒤에는 깊이를 쓰는 프로그램을 시험해 보세요. 깊이는 직접 켜지 않으면 더 이상 켜져 있지 않습니다.
중요한 이유
이번 주 변경 중 네 가지는 잘 돌던 코드를 멈추게 할 수 있습니다. 이번 주에 mjlab 환경을 설치하거나 다시 만들었다면 MuJoCo가 망가졌을 수 있으며 mjviser 상한이 필요합니다. Rerun 0.43은 JavaScript 옵션과 저장소 설정의 이름을 바꾸고, Strands Robots 0.6.0은 0.5.x API를 제거하므로 둘 다 업데이트 전에 코드를 옮겨야 합니다. uni-robot-agent 0.2.0은 클라이언트와 서비스를 함께 업그레이드해야 합니다. MuJoCo 4.0.0을 쓴 분은 4.0.1로 업데이트한 뒤 발산했던 모델을 다시 돌려 보세요. Microduck 0.21 버전은 아직 실제 로봇에서 실행해 보지 않았으므로 먼저 작업대에서 시험해 보세요.