open-wearables

Open Wearables는 여러 공급업체의 웨어러블 기기 데이터를 단일 API 뒤에서 통합하여 AI에 제공하는 오픈소스, 자체 호스팅 플랫폼입니다. 개발자 포털, 정규화된 건강 데이터, 웹훅, 모바일 SDK, 그리고 LLM 및 AI 에이전트를 사용자의 웨어러블 데이터에 연결하기 위한 내장 MCP 서버를 제공합니다. 주요 기능은 다음과 같습니다: - **공급업체 지원**: 클라우드 기반 공급업체(Garmin, Oura, Whoop, Suunto, Polar, Ultrahuman, Strava, Fitbit, Withings, Google Health) 및 SDK 기반 공급업체(Apple Health, Samsung Health, Google Health Connect), Apple Health XML 가져오기 포함. - **AI 통합**: Claude Desktop, Cursor 및 기타 MCP 클라이언트용 내장 MCP 서버; 사용자, 활동 요약, 수면, 운동, 시계열 및 월경 주기에 대한 자연어 쿼리. - **통합 데이터 모델 및 API**: 일일 요약, 시계열, 이벤트, 데이터 우선순위 및 다중 계정 동기화를 갖춘 REST API. - **연결 및 동기화**: OAuth 흐름 관리, 과거 데이터 백필, SSE를 통한 실시간 동기화 진행 상황, 동기화 실행 기록. - **웹훅**: HTTPS 엔드포인트 등록, 이벤트 또는 사용자별 필터링, 서명 검증, 테스트 이벤트 전송, 전달 시도 검사. - **모바일 SDK**: 푸시 기반 건강 데이터 동기화를 위한 iOS(Swift), Android(Kotlin), Flutter(Dart) 및 React Native(TypeScript). - **개발자 포털**: 대시보드, 사용자 관리, 데이터 시각화, 범위 및 동기화 모니터링, 웹훅 관리, 설정 및 시드 데이터 생성기. 아키텍처: FastAPI(Python) 백엔드, React + TanStack Start 프론트엔드, PostgreSQL + Redis 데이터베이스, Celery 작업 큐, 자체 포함 인증, OpenAPI/Swagger 문서를 갖춘 RESTful API. 시작하기: 저장소를 클론하고, 환경 변수를 구성하고, `docker compose up -d`를 실행하고, 개발자 포털에 로그인하고, 선택적으로 샘플 데이터를 시드하고, localhost:8000/docs에서 API 문서를 탐색합니다. 원격 측정: 하루에 한 번(시작 시 포함) 집계 수와 구성 플래그가 포함된 작은 익명 사용량 핑을 보냅니다. `TELEMETRY_ENABLED=false` 또는 `DO_NOT_TRACK=1`로 비활성화할 수 있습니다. 라이선스: MIT. 초기 단계 프로젝트로 활발히 개발 중이며, 버전 1.0 이전에 API가 변경될 수 있습니다.