유팩토리 xArm Python SDK 설치와 빠른 시작 안내

SDK 소개와 지원 제품 번역

xarm-python-sdk는 UFACTORY 로봇을 위한 공식 Python SDK입니다. 확인한 README.rst는 xArm 5·6·7, UFACTORY 850, Lite 6을 지원 제품으로 명시하고 Python 3.5~3.13 호환을 안내합니다. 아래는 짧은 README.rst의 설치·빠른 시작 안내를 한국어로 옮긴 것입니다. 더 긴 README.md의 릴리스 기록과 모든 API를 번역한 자료는 아닙니다. 두 원문과 라이선스를 첨부하며 2026년 5월 27일 저장소 커밋을 기준으로 합니다.

설치와 연결 예제 번역

PyPI에서 설치하는 명령은 pip install xarm-python-sdk입니다. 빠른 시작 코드는 from xarm.wrapper import XArmAPI로 클래스를 가져오고 arm = XArmAPI('192.168.1.100')으로 연결합니다. 이 IP는 원문 예시이므로 실제 로봇 주소로 바꿔야 합니다. 다음 arm.motion_enable(enable=True)는 동작을 활성화합니다. arm.set_mode(0)은 위치 제어 모드, arm.set_state(0)은 준비 상태를 지정합니다.

목표 위치 이동과 연결 종료 번역

원문의 목표 위치 이동 예시는 arm.set_position(x=300, y=0, z=200, roll=180, pitch=0, yaw=0, speed=100)입니다. 마지막 arm.disconnect()로 연결을 종료합니다. 여기에 적힌 좌표·속도는 공식 코드의 예시 그대로이며 사용자의 설치 공간·공구·장애물에 맞는 안전한 목표를 보장하지 않습니다. 로봇 연결 후 실제 동작을 지시하는 코드이므로 해당 모델의 공식 준비·운용 절차를 확인한 뒤 사용해야 합니다.

문서·릴리스 기록·문제 보고 번역

전체 문서와 예제는 공식 xArm-Python-SDK GitHub 저장소에서 제공합니다. 제품 웹사이트는 https://www.ufactory.cc/이며 릴리스 기록은 README.md의 Update Summary로 안내합니다. 오류 보고 주소는 support@ufactory.cc입니다. 원문의 이 경로들을 출처 안내로 제공하며 사용자를 대신해 문의를 보내지 않습니다.

이용 조건과 첨부 범위

라이선스는 BSD 3-Clause입니다. 저작권·조건·면책 고지를 보존하고, 권리자나 기여자의 이름을 편집본 추천·보증에 사용하지 않습니다. 두 README와 LICENSE는 원본 그대로이며 별도 한국어 안내 파일에 번역·해설 사실을 표시합니다. 별도 제품 펌웨어나 외부 배지 이미지는 포함하지 않습니다.

목록보기