open-wearables

Open Wearables 是一个开源、自托管的平台，可将来自多个提供商的可穿戴设备数据统一到一个 API 之后，使其可供 AI 使用。它提供开发者门户、标准化健康数据、webhook、移动端 SDK，以及内置的 MCP 服务器，用于将 LLM 和 AI 代理连接到用户的可穿戴数据。 主要功能包括： - **提供商支持**：基于云端的提供商（Garmin、Oura、Whoop、Suunto、Polar、Ultrahuman、Strava、Fitbit、Withings、Google Health）和基于 SDK 的提供商（Apple Health、Samsung Health、Google Health Connect），以及 Apple Health XML 导入。 - **AI 集成**：内置 MCP 服务器，适用于 Claude Desktop、Cursor 和其他 MCP 客户端；支持对用户、活动摘要、睡眠、锻炼、时间序列和月经周期进行自然语言查询。 - **统一数据模型与 API**：REST API，包含每日摘要、时间序列、事件、数据优先级和多账户同步。 - **连接与同步**：OAuth 流程管理、历史数据回填、通过 SSE 查看实时同步进度，以及同步运行历史。 - **Webhook**：注册 HTTPS 端点、按事件或用户过滤、验证签名、发送测试事件，并检查投递尝试。 - **移动端 SDK**：iOS（Swift）、Android（Kotlin）、Flutter（Dart）和 React Native（TypeScript），用于基于推送的健康数据同步。 - **开发者门户**：仪表盘、用户管理、数据可视化、覆盖率与同步监控、webhook 管理、设置，以及种子数据生成器。 架构：FastAPI（Python）后端、React + TanStack Start 前端、PostgreSQL + Redis 数据库、Celery 任务队列、自包含身份验证、带 OpenAPI/Swagger 文档的 RESTful API。 快速开始：克隆仓库、配置环境变量、运行 `docker compose up -d`、登录开发者门户、可选地填充示例数据，并在 localhost:8000/docs 浏览 API 文档。 遥测：每天发送一次小型匿名使用 ping（启动时也会发送），包含聚合计数和配置标志；可通过 `TELEMETRY_ENABLED=false` 或 `DO_NOT_TRACK=1` 禁用。 许可证：MIT。早期阶段项目，正在积极开发中；API 在 1.0 版本之前可能会发生变化。