문서: https://openwearables.io/docs

다중 제공자로부터의 웨어러블 기기 데이터를 통합하고, 자연어 자동화를 통해 AI 기반 건강 인사이트를 제공하는 오픈소스 플랫폼입니다. 단일 API, 임베디드 위젯, 지능형 웹훅 알림을 활용하여 건강 애플리케이션 구축 속도를 높여보세요.

Open Wearables 는 다중 웨어러블 기기 및 피트니스 플랫폼의 데이터를 연결하고 동기화하기 위한 통합 API 와 개발자 포털을 제공합니다. 각 제공자 (예: Garmin, Whoop, Apple Health) 에 대해 별도의 인테그레이션을 구현하는 대신, 단일 플랫폼을 통해 정규화된 건강 데이터에 접근하고 AI 기반 자동화를 통해 지능적인 건강 인사이트를 구축할 수 있습니다.

중요

개인용: 이 플랫폼은 개발자 전용이 아닙니다. 개인이 자체 호스팅하여 웨어러블 데이터를 직접 통제할 수 있습니다. 기기를 연결하고 통합 API 를 통해 건강 지표를 탐색하며, AI 건강 어시스턴트와 개인 건강 인사이트 자동화 등 upcoming features 에 대해 주목하세요. 가장 좋은 점은 데이터가 귀하의 인프라에 남아있어 완전한 프라이버시와 통제를 가질 수 있다는 점입니다.

건강 애플리케이션 구축을 위한 개발자용:

• 🔌 단일 API 를 통해 다중 웨어러블 제공자를 통합하고, 별도의 구현을 유지하는 대신 하나의 플랫폼을 사용합니다.

• 📊 다른 기기 (심박수, 수면, 활동량, 보폭 등) 에 걸쳐 정규화된 건강 데이터에 접근합니다.

• 🏠 자체 호스팅 솔루션 - 전체 데이터 통제를 가진 자신의 인프라에 배포합니다.

• 🚀 핵심 기능에는 제 3 자 의존성이 없습니다. docker compose up 로 로컬에서 실행합니다.

• 🤖 자연어를 사용하여 AI 기반 건강 인사이트와 자동화를 구축합니다 (곧 출시 예정)

• 🧩 애플리케이션에 쉽게 통합하기 위한 임베디드 위젯을 제공합니다 (곧 출시 예정)

해결하는 문제:

다중 웨어러블을 지원하는 건강 애플리케이션을 구축하려면 일반적으로 다음이 필요합니다:

• Garmin, Whoop, Apple Health 등 각 제공자에 대해 OAuth 플로우, 데이터 매핑 및 동기화 로직 구현에 상당한 개발 노력이 필요함
• 각 서비스에 대한 다른 OAuth 플로우와 API 를 관리해야 함
• 다양한 데이터 형식과 단위를 처리해야 함
• 여러 SDK 를 유지하고 API 변경 사항을 처리해야 함

Open Wearables 는 이러한 복잡성을 다루어 제품 구축에 집중할 수 있게 해줍니다 🚀

• 🏃 피트니스 코칭 애플리케이션: 사용자 웨어러블을 연결하여 맞춤형 훈련 권장사항을 제공합니다. 러닝 코치는 사용자를 생성하고 WhatsApp 를 통해 연결 링크를 공유하며 AI 인사이트 기능을 테스트할 수 있습니다 - 🏥
• 건강 관리 플랫폼: 다양한 기기에서 환자 건강 데이터를 집계하고 건강 알림 자동화를 설정합니다 - 💪
• 웰니스 애플리케이션: AI 기반 인사이트를 사용하여 다중 웨어러블을 통한 사용자 활동을 추적하고 분석합니다 - 🔬
• 연구 프로젝트: 여러 출처에서 표준화된 건강 데이터를 수집합니다 - 🧪
• 제품 피로트: 기술적 배경이 없는 제품 소유자는 자신의 애플리케이션 없이 사용자에게 연결 링크를 공유하여 플랫폼 기능을 테스트할 수 있습니다 - 👤
• 개인용: 개인은 자체 호스팅하여 자신의 웨어러블을 연결하고 AI 건강 어시스턴트를 사용하여 건강 데이터와 대화하며 개인 건강 인사이트를 설정할 수 있습니다. 모든 것이 완전한 데이터 프라이버시와 통제를 가집니다.

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 사용 (권장):
가장 쉬운 방법은 Docker Compose 를 사용하는 것입니다:

docker compose up -d

Docker 없이 로컬 개발 환경 설정을 원하시면 docs 를 참조하세요.

• 개발자 포털 로그인: 스타트업 시에는 ADMIN_EMAIL 와 ADMIN_PASSWORD 환경 변수를 사용하여 자동으로 관리자 계정이 생성됩니다 (기본값: admin@admin.com / your-secure-password).

http://localhost:3000 을 열어 개발자 포털에 액세스하고 API 키를 생성하세요.

**샘플 데이터 시드 **(선택사항): 테스트 사용자 및 샘플 활동 데이터를 원하시면:

make seed

이것은 다음을 생성합니다:

• 테스트 사용자
• 테스트 사용자의 샘플 활동 데이터

API 문서 보기: 브라우저에서 http://localhost:8000/docs 를 열어 인터랙티브 Swagger UI 를 탐색하세요.

통합 관리용 웹 기반 대시보드:

• 📈 일반 통계: 사용자 수 및 데이터 포인트를 한눈에 확인 - 👥
• 사용자 관리: 포털 또는 API 를 통해 사용자를 추가 - 📋
• 사용자 세부 정보: 연결된 데이터 소스, 통합 상태 및 시각화를 통한 사용자 지표 확인 - 🔑
• API 키 관리: Credentials 탭에서 인증서를 생성 및 관리

플랫폼의 가장 강력한 기능 - 자연어로 지능형 건강 인사이트 정의:

• 💬 자연어 조건: 평문으로 알림이 트리거될 때를 설명 - 🔔

• Webhook 알림: 실시간 건강 인사이트를 수신하기 위해 백엔드 엔드포인트 구성 - 🧪

• 테스트 자동화: 역사적 데이터에 대해 dry run 을 실행하여 자동화가 실제로 어떻게 작동하는지 확인 - 👤

• Human-in-the-Loop: 테스트 중 잘못된 AI 해석을 표시하여 시스템을 지속적으로 개선 - ✨

• Improve Description: 자동화 설명을 정교하게 만들기 위한 AI 기반 제안 - 📜

• Automation Logs: 과거 자동화 트리거 검토 및 피드백 제공

• 💬 사용자 데이터 디버깅 및 탐색용 인터랙티브 채팅 인터페이스

• 🧩 몇 줄의 코드로 통합할 수 있는 임베디드 위젯

• 🔄 커스터마이징 가능한 AI 모델 (필요에 따라 모델을 교체)

• 🔍 사용자 건강 지표에 대한 자연어 쿼리

원천 장치와 관계없이 일관된 REST API 를 통해 건강 데이터에 액세스하세요.

• ☁️ 클라우드 기반: Garmin, Suunto, Polar (곧 추가 예정!) - 📱
• SDK 기반: Apple HealthKit, Samsung Health, Google Health Connect

엔드 사용자용 단순화된 연결 프로세스:

• 사용자의 연결 링크 생성 (또는 SDK 위젯 사용)
• 사용자가 웨어러블 제공자와 인증
• 데이터가 자동으로 플랫폼에 동기화됨
• 통합 API 를 통해 액세스

온디바이스 건강 스토어에서 푸시 기반 건강 데이터 동기화를 위한 네이티브 SDK:

iOS SDK(Swift) - Apple HealthKit
Android SDK(Kotlin) - Samsung Health & Google Health Connect
Flutter SDK(Dart) - 네이티브 SDK 를 감싸는 크로스 플랫폼 Flutter 래퍼
React Native SDK(TypeScript) - 네이티브 SDK 를 감싸는 크로스 플랫폼 React Native 래퍼

• 🔌 Connection Widget: 앱에서 직접 웨어러블을 연결할 수 있도록 사용자에게 허용 - 🤖
• AI Health Assistant Widget: 사용자 건강 쿼리를 위한 AI 채팅 인터페이스를 임베드

구현 기술:

• 🐍 Backend: FastAPI (Python) - ⚛️
• Frontend: React + TanStack Router + TypeScript (Vite) - 🗄️
• Database: PostgreSQL + Redis - ⚙️
• Task Queue: Celery (데이터 동기화 및 처리용 백그라운드 작업) - 🔐
• Authentication: 자체 포함 (외부 인증 서비스 필요 없음) - 📡
• API Style: RESTful(OpenAPI/Swagger 문서 포함)

플랫폼은 자체 호스팅을 위해 설계되었으며, 각 배포는 단일 조직에 서비스를 제공합니다. 멀티 테넌시 복잡성은 없습니다.

사용 가능 (Available):

• 개발자 포털
• 사용자 관리 (API 와 개발자 포털을 통해)
• Garmin, Polar, Suunto 의 OAuth 플로우
• Garmin, Polar, Suunto 의 운동 데이터 동기화 및 API 접근
• 모바일 동기화 SDKs (iOS, Android, Flutter, React Native)

개발 중 (In Development):

• 핵심 건강 데이터 엔드포인트
• 건강 인사이트 자동화
• AI 건강 어시스턴트
• 향상된 위젯 통합

다른 개발자들과 연결하고 도움을 받으며 아이디어를 공유하고 최신 개발 동향을 파악하기 위해 Discord 커뮤니티에 참여하세요:

기여는 환영합니다! 이 프로젝트는 웨어러블 데이터 통합을 위한 커뮤니티 주도 솔루션을 목표로 합니다.

CONTRIBUTING.md 를 통해 다음에 대한 자세한 내용을 확인하세요:

• 🛠️ 개발 환경 설정
• 📝 코드 스타일 및 테스트 요구사항
• 🔀 풀 리퀘스트 프로세스

MIT 라이선스 - 상업적 및 오픈 소스 프로젝트에서 자유롭게 사용하세요.

• 💬 GitHub Discussions - 질문 및 아이디어

참고: 이 프로젝트는 활성 개발 중인 초기 단계 프로젝트입니다. 버전 1.0 이전에 API 가 변경될 수 있습니다. 프로덕션에서는 특정 버전에 고정하고 업데이트를 위해 변경 로그를 따르는 것을 권장합니다.

이 프로젝트의 백엔드 부분은 Python AI Kit 에서 생성되었습니다.
❤️ Momentum 에 의해 구축됨