Repolode
krumjahn

krumjahn/applehealth

Apple Health의 export.xml 데이터를 CSV/JSON으로 내보내고 차트로 표시하며, 로컬 또는 클라우드 LLM과 대화할 수 있는 터미널 CLI입니다.

스타
465
포크
38
열린 이슈
1
마지막 커밋
3개월 전

어떤 프로젝트인가요?

healthai는 Apple Health가 생성하는 export.xml 파일을 읽어 레코드, 운동, 활동 요약의 메타데이터를 보존하면서 CSV 또는 JSON 데이터셋으로 변환하는 Python 명령줄 도구입니다. 일일 심박수, 수면, 운동 중 심박수 강도 차트를 생성하고, 집계 전에 거리, 체중, 에너지, 심박수 단위를 정규화합니다.

주요 인터페이스는 자연어로 질문할 수 있는 채팅 REPL입니다. 슬래시 명령으로 걸음 수, 심박수, 수면, 운동, 체중, 진단, 내보내기를 다룹니다. iPhone, Apple Watch, 서드파티 소스에서 겹치는 측정값은 지표별로 설정 가능한 우선순위에 따라 조정하며, 원치 않는 앱을 제외하도록 소스 필터를 설정할 수도 있습니다.

OpenAI, Anthropic, Google, DeepSeek 같은 클라우드 제공업체의 모델이나 Ollama, LM Studio, Jan, llama.cpp, GPT4All 또는 OpenAI 호환 엔드포인트를 통해 제공되는 완전한 로컬 모델을 사용할 수 있어 건강 데이터를 기기에 보관할 수 있습니다.

핵심 기능

  • 01레코드, 운동, 활동 메타데이터를 유지하면서 export.xml을 CSV와 JSON으로 변환합니다.
  • 02건강 데이터에 관해 자연어로 질문하고 답변을 받는 채팅 REPL입니다.
  • 03심박수, 수면, 운동 강도 차트를 생성합니다.
  • 04지표별로 설정 가능한 우선순위와 소스 필터를 사용해 중복되는 데이터를 조정합니다.
  • 05클라우드 LLM 제공업체와 Ollama, LM Studio 및 유사한 서버를 통한 완전한 로컬 모델을 지원합니다.
  • 06미터법 단위와 야드파운드법 단위 간에 전환합니다.

활용 사례

  • Apple Watch와 iPhone에 수년간 쌓인 데이터를 분석해 걸음 수, 수면, 심박수의 추세를 파악합니다.
  • 로컬 모델을 사용해 민감한 건강 기록을 자신의 기기에 보관합니다.
  • Apple Health 데이터를 CSV로 내보내 pandas나 스프레드시트에서 추가 분석합니다.
  • 운동 기록을 살펴 회복 상태가 저하되는 패턴 등을 확인합니다.

빠른 시작

  1. 1

    pipx로 healthai를 설치하세요

    pipx install healthai
  2. 2

    healthai를 실행하고 설정 마법사의 안내에 따라 AI 모델을 선택한 다음 export.xml 파일의 경로를 지정하세요

    healthai

사용 전 알아둘 점

  • 저장소 메타데이터에 라이선스가 표시되어 있지 않아 재사용 조건이 명확하지 않습니다.
  • 채팅 기능을 사용하려면 클라우드 LLM API 키 또는 Ollama와 같은 로컬 설치 모델이 필요합니다.

토픽

자주 묻는 질문

applehealth은(는) 무엇인가요?
Apple Health의 export.xml 데이터를 CSV/JSON으로 내보내고 차트로 표시하며, 로컬 또는 클라우드 LLM과 대화할 수 있는 터미널 CLI입니다. healthai는 Apple Health가 생성하는 export.xml 파일을 읽어 레코드, 운동, 활동 요약의 메타데이터를 보존하면서 CSV 또는 JSON 데이터셋으로 변환하는 Python 명령줄 도구입니다. 일일 심박수, 수면, 운동 중 심박수 강도 차트를 생성하고, 집계 전에 거리, 체중, 에너지, 심박수 단위를 정규화합니다.
applehealth은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
applehealth에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
applehealth은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. applehealth의 마지막 커밋은 2026년 8월 6일입니다.
applehealth은(는) 어디에 사용할 수 있나요?
Apple Watch와 iPhone에 수년간 쌓인 데이터를 분석해 걸음 수, 수면, 심박수의 추세를 파악합니다. 로컬 모델을 사용해 민감한 건강 기록을 자신의 기기에 보관합니다. Apple Health 데이터를 CSV로 내보내 pandas나 스프레드시트에서 추가 분석합니다. 운동 기록을 살펴 회복 상태가 저하되는 패턴 등을 확인합니다.
applehealth는 어떻게 설치하나요?
pipx로 healthai를 설치하세요: pipx install healthai healthai를 실행하고 설정 마법사의 안내에 따라 AI 모델을 선택한 다음 export.xml 파일의 경로를 지정하세요: healthai
applehealth은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/krumjahn/applehealth

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

관련 프로젝트