Repolode
krumjahn

krumjahn/applehealth

Apple Healthのexport.xmlデータをCSV/JSONに書き出してグラフ化し、ローカルまたはクラウドのLLMとチャットできるターミナルCLIです。

スター
465
フォーク
38
未解決の Issue
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 は今もメンテナンスされていますか?
半年以内に更新あり。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 の数値は毎日更新されます。

関連プロジェクト