EulerAtlas

플러그인 기반 로봇 행동 학습 프레임워크 — 우선 공개: 자동차 · 휴머노이드

모방학습(IL)과 FastTD3 강화학습(RL)을 결합한 RL→IL 파이프라인 위에서 동작하는 플러그인 기반 CLI 로봇 행동 학습 프레임워크입니다. 가장 먼저 공개하는 두 플래그십 도메인은 자동차(EulerDrive)휴머노이드(EulerWalk)입니다 — EulerDrive는 멀티카메라 BEV 자율주행(CARLA Town01 클로즈드루프 검증), EulerWalk는 휴머노이드 RL→IL loco-manipulation 정책으로, 둘 다 사전학습 모델을 패키지에 동봉해 학습·시뮬레이터 없이 바로 로드·실행할 수 있습니다. 통합 obs/action 스키마는 자동차·드론·휴머노이드·로봇개·모바일 매니퓰레이션·물류 AGV·농업 로봇·조선소 크레인 등 8개 도메인을 포괄하도록 설계되었고, 도메인은 Domain Plugin으로 독립 배포·계속 확장됩니다.

Open Source · v0.5.0

핵심 기능

우선 공개 2개 도메인(자동차·휴머노이드) + 플러그인으로 확장하는 8개 도메인 스키마 · 모방학습 + FastTD3 강화학습 · SOTA 정책 모델

클래식 도메인 (01–04)

Internal Schema Boundary — 도메인별 고정 차원 스키마로 모든 모듈이 일관되게 소통합니다.

자동차 (road) 4D 상태 + 2D 행동 — CARLA 연동, nuScenes 어댑터
드론 (aerial) 6D 상태 + 3D 행동 — AirSim 스켈레톤
휴머노이드 33D 상태 + 14D 행동 (loco-manip) — MuJoCo Humanoid-v5 / HumanoidBench 연동
로봇개 (quadruped) 12D 상태 + 8D 행동 — MuJoCo Ant-v5 연동

산업 도메인 (05–08)

공장, 물류, 농업, 조선 — 각 도메인 전용 Mock 시뮬레이터와 데이터 어댑터를 포함합니다.

모바일 매니퓰레이션 18D 상태 + 8D 행동 — 추천 모델: ACT
물류 AGV (warehouse) 14D 상태 + 4D 행동 — 추천 모델: BC-RNN
스마트팜 농업 로봇 16D 상태 + 6D 행동 — 추천 모델: Diffusion
조선소 크레인 (shipyard) 20D 상태 + 9D 행동 — 추천 모델: ACT

정책 모델 (코어 5종 + SOTA + RL)

BC-MLP / RNN / CNN기본·시계열·비전 기반 행동 복제
ACTAction Chunking Transformer + CVAE (매니퓰레이션 SOTA)
Diffusion Policy확산 모델 기반 정책 (DDPM)
SOTA (플러그인)BEVFuser(멀티카메라 BEV), TemporalTransformer(Tesla-FSD형), WholeBodyACT(loco/manip 분리 헤드)
RL Actor NEWFastTD3 off-policy RL (twin critic, n-step) — RL→IL 워크플로우

복잡도 레벨 (L0–L2)

L0 (Toy)Mock 시뮬레이터 + BC-MLP — 튜토리얼/CI용
L1 (Intermediate)도메인 추천 모델 + Mock — 알고리즘 연구
L2 (Advanced)실제 백엔드 (CARLA / MuJoCo / HumanoidBench) + SOTA 모델

우선 공개 플래그십 — EulerDrive(자동차) · EulerWalk(휴머노이드)

가장 먼저 공개하는 두 도메인. 사전학습 모델을 패키지에 동봉해 학습·시뮬레이터 없이 바로 로드·실행할 수 있습니다. 나머지 도메인은 플러그인으로 순차 확장됩니다.

EulerDrive (자동차)

멀티카메라 BEV 융합 자율주행. BEVFuserPolicy + IPM BEV 투영 + PID 웨이포인트 컨트롤러로 구성되며, CARLA Town01 3카메라 데이터에서 클로즈드루프로 검증되었습니다.

  • 클로즈드루프 지표: RouteCompletion / InfractionScore / DrivingScore.
  • 검증 결과: CARLA Town01 웨이포인트 손실 14.71 → 4.56 (69% 감소).
  • 동봉 모델: bevfuser_lite_carla_town01.pt.

EulerWalk (휴머노이드)

완전한 RL→IL 파이프라인. FastTD3 강화학습(RLTrainer)으로 전문가를 만들고, 시연을 생성한 뒤 WholeBodyACT 모방 정책으로 증류합니다.

  • 검증 결과: RL 리턴 406 → 418 → IL 손실 1.98e-4, 안정적 롤아웃.
  • 동봉 모델: wholebodyact_locomanip.pt, rl_actor_walk.pt.
  • 스키마: 휴머노이드 33D 상태 / 14D 행동 (loco-manipulation).

※ 우선 공개하는 2개 도메인(자동차·휴머노이드)은 실제 백엔드·데이터셋 기반 연구급입니다. 나머지 6개 도메인은 동일한 통합 스키마 위에서 플러그인으로 순차 공개됩니다.

데이터 파이프라인 & 시뮬레이션

합성 데이터 생성부터 시뮬레이션 롤아웃까지 전체 파이프라인

데이터 파이프라인

합성 데이터 생성, 외부 데이터 수집, 증강, 편집까지 완전한 데이터 워크플로우를 CLI로 수행합니다.

  • Pull: 합성 또는 실제 전문가 시연 데이터 생성/수집.
  • Ingest: JSONL/CSV를 내부 포맷으로 변환.
  • Augment: 노이즈, 미러링, 시간 지터 등 데이터 증강.
  • Edit: 통계 확인, 필터링, 병합, 분할.

시뮬레이션 & 평가

학습된 정책을 시뮬레이션에서 실행하고, 자동으로 평가 지표를 산출합니다.

  • Mock 시뮬레이터: 8개 도메인 전용 내장 시뮬레이터로 즉시 실행 (의존성 없음).
  • 실제 백엔드: CARLA (자동차), MuJoCo (로봇), AirSim/Isaac Lab (스켈레톤).
  • 병렬 시뮬레이션: ParallelSimManager로 N개 인스턴스 동시 실행.
  • 시나리오 스위트: 코너 케이스 시나리오 빌드 및 pass/fail 리포트.

CLI 레퍼런스

커맨드 그룹으로 전체 워크플로우를 수행합니다 (--lang 5개 언어 지원)

init

역할/레벨에서 YAML 설정을 자동 생성합니다.

train

BC/IL 정책을 훈련합니다. 이어하기, GPU, 체크포인트, 프로젝트 추적 지원.

train-rl NEW

FastTD3 강화학습으로 전문가 정책을 학습합니다 (RL→IL 워크플로우).

sim

rollout/replay — 정책 실행·평가. --render / --save-video(MP4) 지원.

data

pull, ingest, augment, edit, collect, generate-demos — 데이터 파이프라인.

model

export/load — 모델 카드(SafeTensors + config.json)를 관리합니다.

skill

내장 스킬 조회, 초기화, 크로스 도메인 전이를 수행합니다.

deploy

MessageBridge(mock/ROS2/ZeroMQ)로 정책을 배포합니다.

scenario

코너 케이스 시나리오 빌드 및 스위트 실행.

validate

YAML 설정 파일 검증 (50+ 규칙).

edge

엣지 학습 라이프사이클 관리 — 온디바이스 학습, 배포, 모니터링.

plugin

Domain Plugin 관리 — 커스텀 도메인 등록, 조회, 초기화.

아키텍처

4계층 추상화 스택으로 역할, 설정, 학습, 평가를 분리합니다

4계층 스택 + Domain Plugin

Layer 4 Skill/Meta-Agent — 역할/미션 기반 추천
Layer 3 Config/Validator — YAML 매니페스트 + 50+ 검증 규칙
Layer 2 Data/Model/Training — 파이프라인, 정책 네트워크, BCTrainer
Layer 1 Sim/Eval/Backend — 시뮬레이터, 평가, 궤적
Domain Plugin 커스텀 도메인(obs/action 스키마, 시뮬레이터, 어댑터)을 플러그인으로 등록

기술 사양

언어 Python 3.11+
프레임워크 PyTorch, Gymnasium
시뮬레이터 Mock (내장), CARLA, MuJoCo
로깅 W&B, MLflow (선택)
모델 포맷 SafeTensors + config.json
에러 포맷 3줄 포맷 (Category / Fix / See)

튜토리얼

단계별 가이드로 EulerAtlas를 빠르게 익히세요

튜토리얼은 공개 예정입니다.

설치 및 시작하기

EulerAtlas를 설치하고 첫 번째 정책을 훈련하세요

설치

pip install -e ".[dev]"

# 3줄로 시작
euleratlas init --role road --level 0
euleratlas train -c config.yml
euleratlas sim rollout -c config.yml

요구 사항

Python 3.11+, PyTorch

MuJoCo, W&B (선택)

EulerAtlas로 8개 도메인의 로봇 정책을 훈련하세요

자동차부터 조선소 크레인까지, 전문가 시연에서 정책까지 3줄 CLI로.

GitHub에서 시작하기 문의하기