Repolode
krumjahn

krumjahn/applehealth

一个终端工具,把 Apple Health 导出的 export.xml 转为 CSV/JSON、生成图表,并可用本地或云端大模型对话分析。

Star
465
Fork
38
未关闭 Issue
1
最近提交
3个月前

这是什么?

healthai 是一个 Python 命令行工具,读取 Apple Health 导出的 export.xml,转换为 CSV 或 JSON 数据集,并保留记录、运动和活动摘要的元数据。它可以生成每日心率、睡眠和运动心率强度等图表,并在聚合前将距离、体重、能量和心率统一为标准单位。

主界面是一个对话式 REPL,可以用自然语言提问,也提供 steps、heartrate、sleep、workouts、weight 等斜杠命令,以及诊断和导出功能。来自 iPhone、Apple Watch 和第三方应用的重叠数据可按指标设置优先级,也可以只保留指定数据源。

模型既可以使用 OpenAI、Anthropic、Google、DeepSeek 等云端服务,也可以通过 Ollama、LM Studio、Jan、llama.cpp、GPT4All 或任何兼容 OpenAI 接口的服务在本地运行,健康数据不必离开本机。

核心功能

  • 01将 export.xml 转为 CSV 和 JSON,并保留记录、运动和活动摘要的元数据。
  • 02对话式界面,可用自然语言询问健康数据。
  • 03生成心率、睡眠和运动强度等图表。
  • 04按指标设置数据源优先级并可过滤来源,处理重叠测量。
  • 05支持云端大模型,也支持通过 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

使用前须知

  • 仓库元数据中未列出许可证,因此使用和再分发条款不明确。
  • 聊天功能需要云端大模型的 API 密钥,或在本地安装such as Ollama 等模型。

标签

常见问题

applehealth 是什么?
一个终端工具,把 Apple Health 导出的 export.xml 转为 CSV/JSON、生成图表,并可用本地或云端大模型对话分析。 healthai 是一个 Python 命令行工具,读取 Apple Health 导出的 export.xml,转换为 CSV 或 JSON 数据集,并保留记录、运动和活动摘要的元数据。它可以生成每日心率、睡眠和运动心率强度等图表,并在聚合前将距离、体重、能量和心率统一为标准单位。
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

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目