CodeWithCJ/SparkyFitness

SparkyFitness 是一个自托管的健身与健康追踪平台，适合希望把饮食、运动、饮水、睡眠、断食、情绪和身体测量集中在一处、而不是分散在多个订阅服务里的家庭。它由后端服务器、Web 前端、iOS/Android 应用以及 Apple Watch/Wear OS 伴生应用组成，数据存放在你自己控制的基础设施上 SparkyFitness 仓库。

实际能做什么

你可以记录饮食、训练、饮水和体重等日常打卡，设置目标，并用图表和自定义日期范围的报告回顾长期历史。它支持多个用户档案和细粒度的家庭共享权限，也支持 OIDC、TOTP、Passkey 和 MFA 登录。睡眠阶段、HRV 和血糖并非由应用自身测量，而是从手表、手机或血糖仪导入后再存储和绘图 项目 README。

数据如何进入系统

平台可对接多种来源：手机端的 Apple Health 与 Google Health Connect，以及 Fitbit、Garmin Connect、Withings、Polar Flow、Oura、Strava、Hevy，还有 OpenFoodFacts、USDA、Mealie 等食物数据库。连接后，步数、训练、睡眠和身体测量会同步到你的服务器 项目 README。部分集成被明确标注为测试不充分（Strava）或依赖非官方 API（Yazio），稳定性不如主流来源。

可选的 AI 与部署选择

SparkyAI 可通过对话记录饮食、运动与身体数据，也支持上传餐食照片自动记录，目前处于 beta 阶段。文档给出两种运行方式：Docker Compose 自托管部署，或通过 PikaPods、Zenith 等第三方托管服务部署，适合不想自己维护服务器的人 项目 README。自托管路径需要自行设置数据库密码、API 加密密钥、认证密钥和前端访问地址；在这些占位值未替换前服务器会拒绝启动。SSO、SMTP、外部数据库和反向代理等完整配置见文档站 安装指南。

需要了解的约束

项目自称是 source-available 而非开源：许可证为非商业用途，商用需要获得许可 许可证。项目还说明正处于活跃开发中，版本之间可能出现破坏性变更，不建议使用自动更新容器，升级前应查看发布说明。AI 聊天、家庭/好友访问和 API 文档均标记为 beta 项目 README。