Physical Labs 소개

Physical Labs 는 RoboSEasy(로보시지)가 만든 무료 로봇 데스크톱 앱입니다. 모터 셋업부터 로봇 보정, 원격 조작, 데이터 수집, 모델 학습, 추론까지 한 창에서 버튼으로 진행합니다. 터미널에 긴 명령을 입력하지 않아도 됩니다. 예전 이름은 RoboSEasy Studio 입니다.

이 설명서는 Ubuntu 판 0.2.0 기준입니다

앱은 프로그램 페이지에서 내려받습니다. Windows 판(0.1.7)과 다른 점은 아래 4.2절에 모았습니다.

학습 목표

  • Physical Labs 로 무엇을 할 수 있는지 설명할 수 있다.
  • 앱이 지원하는 로봇 기종과, 기종마다 쓸 수 있는 탭을 구분할 수 있다.
  • 모터 셋업부터 추론까지 작업 순서를 말할 수 있다.
  • 내 PC 에 맞는 판과 준비물을 확인할 수 있다.

1. Physical Labs 는 어떤 앱인가요?

1.1. 로봇 학습 · 제어를 한 앱에서

로봇으로 새 동작을 가르치려면 여러 단계를 거칩니다. 모터에 번호를 붙이고, 팔을 보정하고, 사람이 직접 조종하며 시범 데이터를 모으고, 그 데이터로 모델을 학습한 뒤 로봇에서 실행합니다. Physical Labs 는 이 단계를 모두 한 앱에 모았습니다.

앱 안에서는 Hugging Face 의 LeRobot 라이브러리(0.6.0)를 씁니다. 그래서 녹화한 데이터셋과 학습한 모델이 LeRobot 형식이고, Hugging Face Hub 에 올려 다른 사람과 나눌 수 있습니다. 앱이 Hub 에 올리는 데이터셋은 누구나 볼 수 있는 공개(public) 저장소가 됩니다.

로그인한 뒤 처음 보이는 Physical Labs 홈 화면 — 왼쪽 사이드바에 모터 셋업 · 로봇 창고 · 데이터셋 창고 · 워크스페이스 메뉴가 있다

로그인하면 보이는 홈 화면입니다. 왼쪽 사이드바에서 할 일을 고릅니다.

1.2. 알아 두면 좋은 특징

특징설명
구글 로그인구글 계정으로 로그인해야 쓸 수 있습니다. 처음 로그인하고 약관에 동의하면 가입이 끝납니다. 로그인 없이 쓰는 방법은 없습니다.
기능 패키지처음 설치에는 기본 구성(로그인 · 모터 셋업 · 로봇 설정)만 들어 있습니다. 칼리브레이션 · 텔레오퍼레이션 · 데이터 · 훈련 같은 탭은 처음 열 때 설치하기 로 필요한 것을 받습니다. 자세한 것은 기능 패키지 설치에 있습니다.
이 PC 에 저장로봇 설정 · 보정 파일 · 데이터셋 · 학습 결과는 앱을 쓰는 PC 에 저장됩니다 (LeKiwi 의 팔로워 보정은 로봇에 저장됩니다).
한국어 화면버튼과 안내 글이 한국어입니다. 일부 조종 화면 이름(Joint Control, Motion Record 등)과 일부 확인 창의 Yes · No 버튼은 영어로 보입니다.

2. 지원하는 로봇

2.1. 기종 표

로봇은 로봇 창고 의 + 로봇 추가 에서 기종을 골라 만듭니다. 아래 표의 이름은 앱 화면에 보이는 글자 그대로입니다.

새 로봇 생성 창 — SO-101 · SO-102 · Lekiwi 카드는 고를 수 있고, reBot · Dual SO-101 · Dual SO-102 카드는 준비 중으로 흐리게 보인다

로봇을 만들 때 기종을 고르는 창입니다. 흐린 카드는 아직 고를 수 없습니다.

앱에 보이는 이름어떤 로봇인가요로보시지 제품쓸 수 있는 탭
SO-1016축(6 DoF) 로봇 팔A-Ba(SO-ARM101)7개 모두
SO-102로보시지가 직접 개발한 7축(7 DoF) 로봇 팔—엔드이펙터 를 뺀 6개 (엔드이펙터 탭은 잠겨 있습니다)
Lekiwi모바일 베이스 + 로봇 팔A-Go(LeKiwi)7개가 모두 보입니다. 새 A-Go(ROS 2 로봇)의 엔드이펙터 는 0.2.0(2026-11-01 재배포)부터 됩니다
reBot · Dual SO-101 · Dual SO-102앞으로 지원할 기종 (Dual 은 양팔 구성)—준비 중 — 아직 고를 수 없습니다

탭 7개는 로봇 설정 · 칼리브레이션 · 엔드이펙터 · 텔레오퍼레이션 · 데이터 · 훈련 · 추론 입니다. 각 탭이 하는 일은 3절에 있습니다.

2.2. 팔 로봇과 LeKiwi 의 차이

팔 로봇 (SO-101 · SO-102)A-Go(LeKiwi)
팔로워 팔PC 에 USB 로 연결로봇의 라즈베리파이에 연결
리더 팔PC 에 USB 로 연결PC 에 USB 로 연결 (SO-101 리더암)
카메라PC 에 USB 로 연결로봇에 달린 전방(front) · 손목(wrist) 카메라
앱이 로봇에 붙는 길USB 케이블와이파이 또는 랜선

이 설명서(Physical Labs)는 팔 로봇을 중심으로 앱의 기능을 설명합니다. LeKiwi 는 로봇 쪽 준비(SD 카드 · 네트워크 · 로봇 웹 화면)가 더 있어서 A-Go(LeKiwi) 설명서에 따로 정리했습니다. 앱에 LeKiwi 를 붙이는 방법은 Physical Labs 연결에서 시작하세요.


3. 할 수 있는 일

3.1. 작업 순서

대부분 아래 순서로 진행합니다. 1~3 은 로봇을 처음 준비할 때 하고, 4~7 은 새 작업을 가르칠 때마다 되풀이합니다.

모터 셋업 → 로봇 설정 → 칼리브레이션 → 텔레오퍼레이션 · 엔드이펙터 → 데이터 수집 → 훈련 → 추론

순서할 일앱에서 여는 곳하는 일
1모터 셋업사이드바 모터 셋업새 STS3215 모터를 한 대씩 연결해 관절 번호(ID)를 붙입니다. ID 가 이미 붙은 팔이면 건너뜁니다.
2로봇 설정로봇 설정 탭로봇 이름과 팔 · 카메라의 USB 포트를 정하고 로봇 저장 을 누릅니다.
3칼리브레이션칼리브레이션 탭팔마다 가운데 자세와 관절이 움직이는 범위를 재서 보정 파일을 만듭니다. 조작 · 수집 · 추론은 이 파일이 있어야 연결됩니다.
4텔레오퍼레이션텔레오퍼레이션 탭리더 팔을 손으로 움직이면 팔로워 팔이 따라 움직입니다. 3D 화면 · 카메라 · 관절 그래프를 함께 보고, 동작을 녹화 · 재생할 수 있습니다.
4엔드이펙터엔드이펙터 탭리더 팔 없이 화면에서 관절 각도나 손끝 좌표(XYZ)로 팔을 움직이고, 자세를 가르칩니다 (SO-101).
5데이터 수집데이터 탭 › 수집리더 팔로 시범 동작을 보이며 카메라 영상과 관절값을 LeRobot 데이터셋으로 녹화합니다.
5데이터셋 창고사이드바 데이터셋 창고데이터셋을 재생 · 편집 · 병합하고, Hugging Face Hub 에 올리거나(공개 저장소로 올라갑니다) 내려받습니다.
6훈련훈련 탭모은 데이터셋으로 ACT · SmolVLA · X-VLA · NVIDIA GROOT 모델을 학습합니다.
7추론추론 탭학습한 모델이 로봇 팔을 스스로 움직입니다.
+워크스페이스사이드바 워크스페이스Yolo + Pick&Place — 카메라로 물체를 찾아 LeKiwi 가 집어 옮깁니다. LeKiwi 전용입니다. 새 A-Go(ROS 2 로봇)는 0.2.0(2026-11-01 재배포)부터 열립니다 (이동 구간은 실물 재조정 중).

SO-101 로봇 a-ba 의 작업 화면 — 위쪽에 로봇 설정부터 추론까지 탭 7개가 있다

로봇 창고에서 로봇을 고르면 열리는 작업 화면입니다. 탭을 왼쪽부터 차례로 진행합니다.

훈련은 로봇을 켜지 않아도 됩니다

훈련 탭은 로봇에 접속하지 않습니다. 로봇이 꺼져 있어도 되고, 학습할 데이터셋이 이 PC 에 있으면 됩니다 (Hub 에만 있는 데이터셋은 먼저 데이터셋 창고에서 내려받습니다). 훈련 탭도 로봇 작업 화면 안에 있으니, 로봇 창고에서 로봇 하나를 열고 들어갑니다.

3.2. 화면은 어떻게 생겼나요?

홈 화면은 위쪽 막대 · 왼쪽 사이드바 · 본문으로 나뉩니다. 위쪽 막대의 ☰ 는 모터 · 팔 시험 도구를 여는 메뉴이고, 사이드바 맨 위의 ☰ 는 사이드바를 접는 버튼입니다. 각 부분은 화면 둘러보기에서 자세히 설명합니다.


4. 어느 판을 쓰나요?

4.1. Ubuntu 판 (이 설명서의 기준)

항목값
판0.2.0
파일physical-labs_0.6.0-0.2.0_amd64.deb — 앞의 0.6.0 은 앱이 쓰는 LeRobot 버전, 뒤의 0.2.0 이 앱 버전입니다
지원 운영체제Ubuntu 24.04 (인텔 · AMD 64비트 PC, amd64). Ubuntu 22.04 에는 설치되지 않습니다
내려받기프로그램 페이지
설치설치와 첫 실행

앱 화면에는 버전이 나오지 않습니다. 설치된 판은 터미널에서 cat /opt/physical-labs/VERSION 으로 확인합니다. 새 판으로 업데이트하면 처음 켤 때 구글 로그인을 한 번 더 합니다.

4.2. Windows 판

Windows 판은 0.1.7 이 최신입니다

Windows 10 · 11 용 설치 파일도 프로그램 페이지에 있습니다. 다만 Windows 0.1.7 에는 아래 기능이 없습니다.

기능Ubuntu 0.2.0Windows 0.1.7
새 A-Go(LeKiwi, ROS 2 로봇) 연결됩니다안 됩니다
SO-102 로봇됩니다준비 중 (고를 수 없음)
USB 포트 고정로봇 저장 때 함께 합니다없습니다. 장치를 다른 USB 포트에 꽂으면 COM 번호가 바뀔 수 있으니 늘 같은 포트에 꽂으세요

macOS 판은 아직 준비 중입니다.


5. 준비물

준비물설명
PCUbuntu 24.04 가 설치된 인텔 · AMD 64비트 PC (Windows 판은 4.2절).
저장 공간설치할 때 /opt 에 3GB 이상 비어 있어야 합니다. 기능 패키지를 모두 받으면 약 1.4GB 가 더 들고, GPU 버전 PyTorch 는 설치하면 약 5.9GB 를 차지합니다. 데이터셋과 학습 결과도 공간을 쓰므로, 학습까지 한다면 20GB 이상 비워 두세요 (훈련 탭의 환경 진단은 20GB 미만이면 주의 로 표시합니다).
인터넷설치할 때, 앱을 켤 때마다(구글 로그인 확인), 기능 패키지를 받을 때, Hugging Face Hub 에 올리거나 내려받을 때 필요합니다.
구글 계정로그인에 씁니다.
관리자 비밀번호Ubuntu 에서 앱을 설치할 때, 기능 패키지를 설치할 때, 로봇을 저장하거나 지울 때(USB 포트 고정 규칙) 묻습니다.
NVIDIA GPU (선택)학습을 빠르게 하려면 필요합니다. GPU 가 없으면 CPU 로 학습하는데, 매우 느릴 수 있습니다. 드라이버 570 이상이면 앱이 GPU 버전 PyTorch 설치를 안내합니다 (훈련). 추론도 GPU 가 있으면 GPU 를 쓰고, 모터 셋업 · 조작 · 데이터 수집에는 GPU 가 필요 없습니다.
로봇 (팔)SO-101 또는 SO-102 의 팔로워 팔 · 리더 팔, 각 팔의 모터 보드 USB 케이블과 모터 전원, 팔 주변을 찍을 USB 카메라.
로봇 (LeKiwi)A-Go(LeKiwi), SO-101 리더암(USB 케이블 · 전원), 로봇과 PC 가 함께 붙을 네트워크(공유기 · 로봇 AP · 랜선 중 하나 — 네트워크).

앱을 켤 때 인터넷이 필요합니다

앱은 켤 때마다 구글 로그인을 확인합니다. 인터넷 없이 켜면 로그인 화면에서 더 나아가지 못합니다. 저장된 로그인의 기한이 지난 때라면 그 로그인이 지워져, 인터넷이 돌아온 뒤 다시 로그인해야 합니다. 노트북을 로봇 AP(인터넷 없음)에 붙여 쓸 때는 인터넷이 될 때 앱을 먼저 켜 두고 와이파이를 바꾸세요. 켜 둔 앱은 계속 쓸 수 있습니다.


6. 설명서 읽는 순서

처음이라면 위에서부터 차례로 읽으세요. 이미 해 본 단계는 건너뛰어도 됩니다.

묶음문서이럴 때 읽으세요
시작하기설치와 첫 실행앱을 설치하고 처음 로그인할 때
화면 둘러보기사이드바 · 메뉴 · 탭이 어디 있는지 알고 싶을 때
기능 패키지 설치탭을 열었더니 “추가 설치가 필요합니다” 가 뜰 때
로봇 준비모터 셋업새 모터에 ID 를 붙일 때
로봇 설정로봇을 앱에 등록할 때
칼리브레이션팔을 보정할 때
조작엔드이펙터화면에서 팔을 직접 움직일 때
텔레오퍼레이션리더 팔로 팔로워 팔을 움직일 때
데이터데이터 수집학습용 시범 데이터를 녹화할 때
데이터셋 창고데이터셋을 보거나 고치거나 올릴 때
학습 · 추론훈련모델을 학습할 때
추론학습한 모델로 로봇을 움직일 때
워크스페이스Yolo + Pick&Place 를 쓸 때
도움말설정화면 배율 · API 키 · 계정을 바꿀 때
문제 해결잘 안 될 때

A-Go(LeKiwi) 를 쓴다면

로봇 쪽 준비는 A-Go(LeKiwi) 소개부터 읽고, 앱에 붙인 뒤의 흐름은 Physical Labs 연결 → 데이터 · 학습 · 추론을 따라가세요. A-Ba(SO-ARM101) 팔을 조립하는 방법은 A-Ba(SO-ARM101) 설명서에 있습니다.


7. 정리

다음 단계로 앱을 설치하고 처음 로그인해 보세요.