Repolode
Open-RUA

Open-RUA/uni-robot-agent

LLM 에이전트가 공통 도구를 통해 로봇을 제어하도록 지원하는 오픈소스 하네스로, Codex 및 Claude Code 런타임과 시뮬레이터 통합 기능을 제공합니다.

스타
258
포크
19
열린 이슈
1
마지막 커밋
22시간 전

어떤 프로젝트인가요?

uni-robot-agent는 로봇 제어 에이전트를 위한 Python 하네스입니다. 여러 시뮬레이션 환경에서 에이전트가 공통 로봇 도구와 피드백을 사용할 수 있도록 하며, 각 환경의 네이티브 API는 어댑터가 처리합니다. 패키지에는 CLI, Python SDK, 실시간 모니터링 및 재생을 위한 로컬 대시보드와 RoboDojo, RoboUse, RoboLab 시뮬레이터 통합 기능이 포함됩니다.

두 가지 제어 모드를 지원합니다. Direct 모드에서는 에이전트가 로봇 도구를 직접 호출하고, Hybrid 모드에서는 Pi0.5 같은 호환 액션 모델을 추가합니다. 명시적인 인터페이스를 통해 에이전트 런타임, 모델 제공자, 도구, 환경을 교체할 수 있습니다. RoboDojo에서는 기본적으로 Depth가 활성화되며, RGB 전용 관측 설정에서는 이를 끌 수 있습니다.

이 프로젝트는 오픈 모델로 로봇 조작 에이전트를 평가하려는 연구자와 개발자를 대상으로 합니다. ARX One 및 Franka용 실제 로봇 통합은 곧 제공될 예정입니다.

핵심 기능

  • 01시뮬레이션 환경 전반에서 공통으로 사용하는 로봇 도구 인터페이스
  • 02Direct 및 Hybrid 제어 모드 지원. Hybrid 모드에는 Pi0.5 액션 모델이 추가됩니다.
  • 03세션 실행 및 커스텀 전략 구현을 위한 Python SDK
  • 04저장된 에피소드의 실시간 모니터링 및 재생을 지원하는 로컬 웹 대시보드
  • 05교체 가능한 에이전트 런타임, 모델 제공자 및 환경

활용 사례

  • RoboDojo 또는 RoboUse 작업에서 로봇 조작 에이전트 벤치마킹
  • RGB 전용 관측으로 로봇 제어를 위한 오픈 비전-언어 모델 테스트
  • 공통 로봇 도구를 기반으로 커스텀 제어 전략 구축
  • 재생 대시보드에서 저장된 에이전트 실행 기록과 도구 호출 검토

빠른 시작

  1. 1

    PyPI에서 패키지를 설치합니다

    pip install uni-robot-agent
  2. 2

    RoboDojo 통합을 준비합니다

    uni-robot-agent setup --integration robodojo
  3. 3

    API 키와 공급자 엔드포인트를 설정합니다

    export UNI_ROBOT_AGENT_API_KEY='YOUR_API_KEY'
  4. 4

    로컬 대시보드에서 작업을 실행합니다

    uni-robot-agent run --integration robodojo --deploy local --task stack_bowls --model YOUR_MODEL_ID --action-profile direct --no-sam3 --output-dir ./runs --monitor

사용 전 알아둘 점

  • 설정은 Linux GPU 호스트의 Python 3.11 환경을 기준으로 설계되었습니다.
  • 시뮬레이터를 실행하려면 모델 API 키와 Responses 호환 공급자 엔드포인트가 필요합니다.
  • 실제 로봇 통합은 아직 제공되지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

uni-robot-agent은(는) 무엇인가요?
LLM 에이전트가 공통 도구를 통해 로봇을 제어하도록 지원하는 오픈소스 하네스로, Codex 및 Claude Code 런타임과 시뮬레이터 통합 기능을 제공합니다. uni-robot-agent는 로봇 제어 에이전트를 위한 Python 하네스입니다. 여러 시뮬레이션 환경에서 에이전트가 공통 로봇 도구와 피드백을 사용할 수 있도록 하며, 각 환경의 네이티브 API는 어댑터가 처리합니다. 패키지에는 CLI, Python SDK, 실시간 모니터링 및 재생을 위한 로컬 대시보드와 RoboDojo, RoboUse, RoboLab 시뮬레이터 통합 기능이 포함됩니다.
uni-robot-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
uni-robot-agent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
uni-robot-agent은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. uni-robot-agent의 마지막 커밋은 2026년 11월 6일입니다.
uni-robot-agent은(는) 어디에 사용할 수 있나요?
RoboDojo 또는 RoboUse 작업에서 로봇 조작 에이전트 벤치마킹 RGB 전용 관측으로 로봇 제어를 위한 오픈 비전-언어 모델 테스트 공통 로봇 도구를 기반으로 커스텀 제어 전략 구축 재생 대시보드에서 저장된 에이전트 실행 기록과 도구 호출 검토
uni-robot-agent는 어떻게 설치하나요?
PyPI에서 패키지를 설치합니다: pip install uni-robot-agent RoboDojo 통합을 준비합니다: uni-robot-agent setup --integration robodojo API 키와 공급자 엔드포인트를 설정합니다: export UNI_ROBOT_AGENT_API_KEY='YOUR_API_KEY' 로컬 대시보드에서 작업을 실행합니다: uni-robot-agent run --integration robodojo --deploy local --task stack_bowls --model YOUR_MODEL_ID --action-profile direct --no-sam3 --output-dir ./runs --monitor
uni-robot-agent은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Open-RUA/uni-robot-agent

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트