Repolode
the-momentum

the-momentum/open-wearables

여러 웨어러블 데이터 제공업체의 건강 데이터를 하나의 정규화된 API로 통합하고, 웹훅과 AI 도구용 MCP 서버를 제공하는 셀프 호스팅 플랫폼입니다.

스타
2,704
포크
528
열린 이슈
198
마지막 커밋
20시간 전

어떤 프로젝트인가요?

Open Wearables는 Garmin, Oura, Whoop, Suunto, Polar, Strava, Fitbit, Apple Health 등 다양한 웨어러블 기기와 피트니스 서비스의 데이터에 연결하고, 이를 단일 REST API로 제공합니다. 모든 데이터가 활동, 수면, 운동은 물론 심박수와 HRV 같은 시계열 데이터까지 포괄하는 하나의 정규화된 데이터 모델로 반환되므로, 개발자가 제공업체마다 별도의 OAuth 흐름, 데이터 매핑, 동기화 로직을 구현할 필요가 없습니다.

이 프로젝트는 셀프 호스팅을 고려해 설계되었으며, FastAPI 백엔드, SvelteKit 개발자 포털, PostgreSQL, Redis, 백그라운드 동기화를 위한 Celery를 사용합니다. 새 데이터 이벤트를 위한 웹훅, 실시간 동기화 상태 스트림, 기기 내 건강 데이터 저장소에서 데이터를 전송하는 네이티브 iOS, Android, Flutter, React Native SDK도 포함되어 있습니다. 내장 MCP 서버를 사용하면 Claude, Cursor 및 기타 MCP 클라이언트에서 자연어로 사용자의 웨어러블 데이터를 조회할 수 있습니다.

다양한 기기 지원이 필요한 건강 앱 팀, 표준화된 데이터를 수집하는 연구 프로젝트, 웨어러블 데이터를 자체 인프라에 보관하고 싶은 개인에게 적합합니다.

핵심 기능

  • 01클라우드 및 SDK 기반 웨어러블 제공업체의 데이터를 정규화하는 통합 REST API.
  • 02Claude, Cursor 및 기타 MCP 클라이언트에서 웨어러블 데이터를 조회할 수 있는 내장 MCP 서버.
  • 03이벤트 필터, 서명 검증, 전송 내역 확인 기능을 갖춘 웹훅.
  • 04대용량 파일의 S3 멀티파트 업로드를 지원하는 Apple Health XML 내보내기 파일 가져오기.
  • 05기기 내 건강 데이터 동기화를 위한 네이티브 iOS, Android, Flutter, React Native SDK.
  • 06API 키, 사용자, 동기화 상태를 관리하는 개발자 포털이 포함된 Docker Compose 구성.

활용 사례

  • 사용자의 실제 수면 및 운동 데이터를 바탕으로 AI 건강 코치의 답변을 제공하는 경우.
  • 의료 또는 웰니스 앱에서 환자나 고객의 웨어러블 데이터를 통합하는 경우.
  • 연구 프로젝트를 위해 여러 기기의 건강 데이터를 표준화된 형식으로 수집하는 경우.
  • 개인 웨어러블 데이터 저장소를 셀프 호스팅하고 MCP 클라이언트로 조회하는 경우.

빠른 시작

  1. 1

    리포지토리를 클론합니다

    git clone https://github.com/the-momentum/open-wearables.git
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd open-wearables
  3. 3

    백엔드 환경 파일을 복사합니다

    cp ./backend/config/.env.example ./backend/config/.env
  4. 4

    프런트엔드 환경 파일을 복사합니다

    cp ./frontend/.env.example ./frontend/.env
  5. 5

    Docker Compose로 애플리케이션을 시작합니다

    docker compose up -d

사용 전 알아둘 점

  • 초기 단계의 프로젝트로, 버전 1.0 이전에 API가 변경될 수 있습니다.
  • 기본 Docker Compose 설정은 개발용이며, 프로덕션에서는 공식 이미지 버전을 고정해야 합니다.
  • 실행하려면 셀프 호스팅과 Docker 설정이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

open-wearables은(는) 무엇인가요?
여러 웨어러블 데이터 제공업체의 건강 데이터를 하나의 정규화된 API로 통합하고, 웹훅과 AI 도구용 MCP 서버를 제공하는 셀프 호스팅 플랫폼입니다. Open Wearables는 Garmin, Oura, Whoop, Suunto, Polar, Strava, Fitbit, Apple Health 등 다양한 웨어러블 기기와 피트니스 서비스의 데이터에 연결하고, 이를 단일 REST API로 제공합니다. 모든 데이터가 활동, 수면, 운동은 물론 심박수와 HRV 같은 시계열 데이터까지 포괄하는 하나의 정규화된 데이터 모델로 반환되므로, 개발자가 제공업체마다 별도의 OAuth 흐름, 데이터 매핑, 동기화 로직을 구현할 필요가 없습니다.
open-wearables은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
open-wearables은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
open-wearables은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. open-wearables의 마지막 커밋은 2026년 10월 23일입니다.
open-wearables은(는) 어디에 사용할 수 있나요?
사용자의 실제 수면 및 운동 데이터를 바탕으로 AI 건강 코치의 답변을 제공하는 경우. 의료 또는 웰니스 앱에서 환자나 고객의 웨어러블 데이터를 통합하는 경우. 연구 프로젝트를 위해 여러 기기의 건강 데이터를 표준화된 형식으로 수집하는 경우. 개인 웨어러블 데이터 저장소를 셀프 호스팅하고 MCP 클라이언트로 조회하는 경우.
open-wearables는 어떻게 설치하나요?
리포지토리를 클론합니다: git clone https://github.com/the-momentum/open-wearables.git 프로젝트 디렉터리로 이동합니다: cd open-wearables 백엔드 환경 파일을 복사합니다: cp ./backend/config/.env.example ./backend/config/.env 프런트엔드 환경 파일을 복사합니다: cp ./frontend/.env.example ./frontend/.env Docker Compose로 애플리케이션을 시작합니다: docker compose up -d
open-wearables은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/the-momentum/open-wearables

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

관련 프로젝트