Muse Gadget SDK: ESP32·Linux 기기를 Muse 앱에 연결하는 개발 도구
ESP32 보드나 Linux 컴퓨터를 Muse 앱과 연결하는 자작 기기 개발 도구예요. 화면·버튼·센서 등을 붙이거나 Linux 명령과 파일 작업을 연결할 수 있어요. 독립 실행형 로컬 LLM이나 완성된 로봇 제품은 아니에요.
주요 기능
ESP32 주변 장치 연결
지원 보드에 펌웨어를 올려 표시등·화면·버튼·음성 등 보드별 기능을 사용해요. 일부 보드의 홈 네트워크 터널은 로컬 HTTP 기기와 연결하는 경로예요.
Linux 장치 제어
system.run, file.read/write, device.health로 명령 실행·파일 입출력·장치 상태를 제공해요. 연결한 사용자 계정의 실제 권한으로 동작해요.
확장 가능한 공개 SDK
ESP32와 Linux SDK, 스마트폰 테스트 앱 및 통신 문서를 공개해요. 새 센서·기기 명령을 추가하는 출발점이며 보드마다 구현 범위가 달라요.
구조
Muse 스마트폰 앱과 SDK 장치를 페어링한 뒤 서비스 연결을 유지하는 구조예요. ESP32는 ESP-IDF 펌웨어, Linux는 Python 패키지·백그라운드 서비스로 구성돼요. 코드 공개와 Muse 서비스 이용 권한은 별개예요.
누구에게 쓸모 있나요
- ESP32·라즈베리파이로 AI 표시 장치나 센서 연결을 실험하는 개발자에게 적합해요.
- 대표님의 소형 AI 기기 관심과 맞지만, 보유한 구형 ESP32의 정확한 모델·메모리·배선을 확인해야 해요. 기존 Windows AI 서버를 바로 대체하는 프로그램은 아니에요.
설치 전 준비
- 공통: Muse 앱, 네트워크, 기기별 SDK 토큰과 Gadget SDK Terms 검토가 필요해요. 토큰 생성·약관 동의는 수행하지 않았어요.
- ESP32: 문서는 macOS/Linux 개발 PC, 데이터 USB 케이블, ESP-IDF 6.0.1을 지정해요. 기본 보드는 ESP32-C5 DevKitC-1이며 다른 보드는 별도 빌드 구성을 사용해요.
- Linux: Bluetooth LE, Python 3.9+, sudo 가능한 설치 계정. Raspberry Pi OS Bullseye+, Debian 11+, Ubuntu 22.04+, Arch/Fedora 조건이 문서화되어 있어요. Windows 네이티브 설치는 이번 문서에서 확인하지 못했어요.
- ESP32 펌웨어 빌드: macOS / Linux
- 장치 실행: 지원 ESP32 또는 Bluetooth LE Linux
- Linux manifest: musegadget 0.1.0, Python >=3.9
설치 방법
1. 장치·서비스 조건부터 확인
공식 보드 목록과 모델별 기능을 대조하고 SDK 토큰·서비스 이용 조건을 확인해요. 아래 명령은 안내용이며 실행하지 않았어요.
2. ESP32 소스 준비·빌드
menuconfig에서 SDK 토큰 등 설정을 입력해요. 기본 보드가 아닌 경우 해당 보드 절차를 먼저 적용해요. 다운로드 스크립트 즉시 실행·샌드박스 해제는 이 안내에서 수행하지 않습니다.
git clone https://github.com/facebookincubator/muse-gadget-sdk.git
cd muse-gadget-sdk/esp32
# ESP-IDF 6.0.1 환경 준비 후
idf.py menuconfig
idf.py build3. ESP32 기록 또는 Linux 설치
ESP32는 올바른 USB 포트와 보드가 확인된 뒤 공식 flash 절차를 사용해요. Linux는 install.sh를 먼저 읽고 실행 계정·토큰·서비스 생성 내용을 검토해요. 설치기는 /opt/musegadget와 지속 실행 서비스를 구성하므로 단순 파일 열기가 아니에요.
사용 방법
앱에서 페어링
Muse 앱 Settings → Devices에서 Developer mode를 켜고 본인 기기를 추가해요. ESP32는 물리 버튼 확인, Linux는 설치 또는 pair 명령으로 열린 연결 창을 이용해요.
제한된 기능부터 확인
장치 상태 조회와 표시등·화면 같은 작은 실험부터 진행해요. 파일 쓰기·시스템 명령·실제 액추에이터는 영향과 권한을 별도로 검토해요.
자작 기기로 확장
보드별 화면·오디오 지원을 확인해 센서나 버튼 기능을 추가해요. 공식 문서의 성능 수치는 자체 시험 결과로 재검증하지 않았어요.
비용과 API 키
공개 소스 라이선스와 별개로 보드·화면·센서·전원 등 하드웨어 비용이 들어요. Muse 서비스·SDK 토큰의 현재 이용 가능 지역, 요금·할당량은 확인하지 못했어요. 무료 서비스나 기존 AI 구독 호환을 보장하지 않습니다.
라이선스
루트는 Apache-2.0예요. 저작권·라이선스 고지와 변경 사항 표기 등 배포 조건을 확인해야 해요. README는 제3자 코드·폰트의 별도 라이선스, Jollybot 아바타 제외, x264를 포함한 테스트 앱의 GPL 조건을 구분해요. SDK 서비스 약관도 별도예요.
주의사항과 알려진 이슈
- Linux 설치기는 선택한 계정에 관리자 권한이 있으면 Muse도 해당 시스템 전반에 접근할 수 있다고 경고해요. 시험용 계정·기기에서 최소 권한으로 검토해야 해요.
- 펌웨어 기록은 기기 손상·보증 상실·전원 문제를 유발할 수 있어요. 모터·전열 기기 등 위험한 출력에 AI 명령을 바로 연결하지 않습니다.
- 공식 문서는 커뮤니티 기기 페어링에 제조사 검증이 없어 능동 중간자 공격을 막지 못한다고 명시해요. 신뢰하는 네트워크에서 본인 기기인지 확인해요.
- SDK 토큰·Wi-Fi 정보·음성·파일은 민감할 수 있어요. 토큰을 공개 문서에 복사하지 않고 외부 서비스 연결 범위를 확인해요.
- Linux 연결을 끊어도 이미 시작된 명령이 중지되는 것은 아니에요. 원격 연결 해제를 비상 정지 수단으로 간주하지 않습니다.
확인 범위
확인 날짜: 2026-10-30
확인 커밋: 4737636133c9a0253d0b778333605b16fd2626c1
확인한 범위: 2026-10-30 22:33~22:34 KST 공식 main 커밋, README, ESP32/Linux 문서, LICENSE, Linux pyproject·설치기·CLI 일부를 읽었습니다.
확인 한계: SDK·펌웨어 설치·빌드·실행·기기 기록·페어링·SDK 토큰 생성·로그인·결제·약관 수락은 하지 않았어요. 하드웨어 호환성·음성 품질·성능·보안 전체 감사 및 서비스 이용 가능 여부는 미검증이에요.