5分钟快速上手Open WearablesDocker一键部署你的第一个可穿戴设备统一API【免费下载链接】open-wearablesSelf-hosted platform to unify wearable health data through one AI-ready API.项目地址: https://gitcode.com/gh_mirrors/op/open-wearablesOpen Wearables 是一个开源的自托管平台它能把你手环、手表、健身平台的数据Garmin、Oura、Whoop、Apple Health 等十几家厂商汇聚成一个统一的 AI-ready API。对于新手来说最大的痛点是每家厂商的 OAuth、数据格式、单位都不一样——而 Open Wearables 帮你把这些全部统一了。本文将带你用Docker Compose 一条命令完成部署5 分钟内跑通你的第一个可穿戴设备统一 API并拿到第一个 API Key。为什么值得花5分钟部署它传统做法是要为每家设备厂商分别实现 OAuth 登录、数据同步、格式转换工作量巨大。Open Wearables 把这些复杂度全部封装在一个平台里一个 API 对接所有厂商Garmin、Oura、Whoop、Polar、Strava、Fitbit、Withings、Google Health以及通过 SDK 接入的 Apple Health、Samsung Health统一数据模型心率、HRV、血氧、睡眠、运动、体重等数据类型跨设备一致完全自托管数据存放在你自己的服务器上无第三方依赖内置 MCP Server让 Claude、Cursor 等 AI 直接查询用户的健康数据下图是 Open Wearables 的整体数据流可穿戴设备数据经过统一后既可以通过 REST API 供你的应用查询也可以驱动 Webhooks 和 MCP Server部署前准备确认 Docker 环境整个平台只依赖 docker-compose.yml 中定义的服务PostgreSQL 18 Redis 8 FastAPI 后端 Celery 任务队列 React 前端全部容器化无需手动安装任何数据库或 Python 环境。只需确认本机已安装 Docker 并启用了 Compose 插件docker compose version第一步克隆 Open Wearables 仓库git clone https://gitcode.com/gh_mirrors/op/open-wearables cd open-wearables第二步配置文件——复制两个 .env 即可平台的所有配置都来自环境变量仓库已提供可直接使用的开发默认值复制两份文件即可cp ./backend/config/.env.example ./backend/config/.env cp ./frontend/.env.example ./frontend/.env后端配置模板见 backend/config/.env.example其中DB_HOSTdb、REDIS_HOSTredis已按 compose 网络预填好开箱即用前端配置模板 frontend/.env.example 中VITE_API_URL默认指向http://localhost:8000本地试用无需修改本地试用可保持默认值如果要上生产环境建议至少修改这几项在backend/config/.env中变量说明SECRET_KEY用于签发 token 的密钥改成随机长字符串DB_PASSWORD数据库密码替换默认弱密码ADMIN_EMAIL/ADMIN_PASSWORD首次启动自动创建的管理员账号API_BASE_URL公网部署时设为你的 API 域名安全提示默认管理员账号为adminadmin.com/your-secure-password且该账号只在管理员表为空时创建一次。登录后请立即在开发者门户中修改密码。第三步Docker 一键启动全部服务docker compose up -d一条命令就会拉起 PostgreSQL、Redis、后端 API、Celery worker/beat、Webhook 服务svix和前端门户。首次启动需要构建镜像并执行数据库迁移耐心等待几分钟。用以下命令确认状态docker compose ps看到所有服务Up、且db显示healthy就成功了。API 就绪后验证一下curl http://localhost:8000/ # 返回: {message: Server is running!}第四步登录开发者门户创建你的第一个 API Key打开浏览器访问http://localhost:3000用管理员账号登录开发者门户在Settings → API Keys中生成一个 API Key⚠️立即复制保存Key 只显示一次之后无法再查看开发者门户是管理整个部署的控制台管理用户、查看各厂商数据覆盖度、监控同步运行、配置 Webhooks、管理数据优先级多家设备数据重叠时谁优先等都可以在这完成。第五步发起第一次 API 调用打开http://localhost:8000/docs就能看到交互式 Swagger 文档所有端点都可以在线调试。用刚才的 API Key 发起第一个请求curl http://localhost:8000/api/v1/users \ -H X-Open-Wearables-API-Key: YOUR_API_KEY想让数据更真实仓库提供了种子脚本一键生成测试用户和示例活动数据make seed对应逻辑在 backend/scripts/init/seed_activity_data.py常用命令都在 Makefile 中make help可以查看全部。部署成功后连接你的第一台设备以云厂商为例部署完成后的集成流程如图所示——你的应用调用 Open Wearables 创建用户并获取 OAuth 授权链接用户在厂商侧登录后数据自动回同步之后就能通过统一 Data API 取数操作路径在开发者门户中Add User→ 选择厂商如 Garmin / Oura生成连接链接 → 用户授权后历史数据会自动回填后续增量通过定时同步 Webhook 推送。各厂商支持的数据类型详见 docs/providers/coverage.mdx。统一数据模型把「事件」运动、睡眠和「时序数据」心率、HRV、血氧、体重等分开存储每种数据按用户形成独立序列这也是 API 查询简单直接的原因常见问题排查问题解决方法端口冲突5432/8000/3000被占用时在 compose 中用DB_PORT、API_PORT、FRONTEND_PORT环境变量改端口不确定哪个容器出错docker compose logs -f实时查看全部日志API 迟迟不通首次启动要跑数据库迁移稍等后重试迁移文件位于 backend/migrations/versions/想彻底重来docker compose down -v停掉并清空数据卷更完整的本地开发不用 Docker方式可以参考官方文档 docs/quickstart.mdx。总结你完成了什么现在你已经在自己的服务器上跑起了一个完整的工作流克隆仓库 → 复制两份 .env →docker compose up -d→ 登录门户拿 API Key → 第一次 API 调用成功。接下来可以 连接你的第一台真实设备Garmin / Oura / Whoop 等 在门户注册 Webhook 端点实时接收新数据事件 配置内置 MCP Server让 AI 助手直接回答我上周睡眠质量如何Open Wearables 采用 MIT 协议可自由用于商业与开源项目。祝部署顺利【免费下载链接】open-wearablesSelf-hosted platform to unify wearable health data through one AI-ready API.项目地址: https://gitcode.com/gh_mirrors/op/open-wearables创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5分钟快速上手Open Wearables：Docker一键部署你的第一个可穿戴设备统一API
5分钟快速上手Open WearablesDocker一键部署你的第一个可穿戴设备统一API【免费下载链接】open-wearablesSelf-hosted platform to unify wearable health data through one AI-ready API.项目地址: https://gitcode.com/gh_mirrors/op/open-wearablesOpen Wearables 是一个开源的自托管平台它能把你手环、手表、健身平台的数据Garmin、Oura、Whoop、Apple Health 等十几家厂商汇聚成一个统一的 AI-ready API。对于新手来说最大的痛点是每家厂商的 OAuth、数据格式、单位都不一样——而 Open Wearables 帮你把这些全部统一了。本文将带你用Docker Compose 一条命令完成部署5 分钟内跑通你的第一个可穿戴设备统一 API并拿到第一个 API Key。为什么值得花5分钟部署它传统做法是要为每家设备厂商分别实现 OAuth 登录、数据同步、格式转换工作量巨大。Open Wearables 把这些复杂度全部封装在一个平台里一个 API 对接所有厂商Garmin、Oura、Whoop、Polar、Strava、Fitbit、Withings、Google Health以及通过 SDK 接入的 Apple Health、Samsung Health统一数据模型心率、HRV、血氧、睡眠、运动、体重等数据类型跨设备一致完全自托管数据存放在你自己的服务器上无第三方依赖内置 MCP Server让 Claude、Cursor 等 AI 直接查询用户的健康数据下图是 Open Wearables 的整体数据流可穿戴设备数据经过统一后既可以通过 REST API 供你的应用查询也可以驱动 Webhooks 和 MCP Server部署前准备确认 Docker 环境整个平台只依赖 docker-compose.yml 中定义的服务PostgreSQL 18 Redis 8 FastAPI 后端 Celery 任务队列 React 前端全部容器化无需手动安装任何数据库或 Python 环境。只需确认本机已安装 Docker 并启用了 Compose 插件docker compose version第一步克隆 Open Wearables 仓库git clone https://gitcode.com/gh_mirrors/op/open-wearables cd open-wearables第二步配置文件——复制两个 .env 即可平台的所有配置都来自环境变量仓库已提供可直接使用的开发默认值复制两份文件即可cp ./backend/config/.env.example ./backend/config/.env cp ./frontend/.env.example ./frontend/.env后端配置模板见 backend/config/.env.example其中DB_HOSTdb、REDIS_HOSTredis已按 compose 网络预填好开箱即用前端配置模板 frontend/.env.example 中VITE_API_URL默认指向http://localhost:8000本地试用无需修改本地试用可保持默认值如果要上生产环境建议至少修改这几项在backend/config/.env中变量说明SECRET_KEY用于签发 token 的密钥改成随机长字符串DB_PASSWORD数据库密码替换默认弱密码ADMIN_EMAIL/ADMIN_PASSWORD首次启动自动创建的管理员账号API_BASE_URL公网部署时设为你的 API 域名安全提示默认管理员账号为adminadmin.com/your-secure-password且该账号只在管理员表为空时创建一次。登录后请立即在开发者门户中修改密码。第三步Docker 一键启动全部服务docker compose up -d一条命令就会拉起 PostgreSQL、Redis、后端 API、Celery worker/beat、Webhook 服务svix和前端门户。首次启动需要构建镜像并执行数据库迁移耐心等待几分钟。用以下命令确认状态docker compose ps看到所有服务Up、且db显示healthy就成功了。API 就绪后验证一下curl http://localhost:8000/ # 返回: {message: Server is running!}第四步登录开发者门户创建你的第一个 API Key打开浏览器访问http://localhost:3000用管理员账号登录开发者门户在Settings → API Keys中生成一个 API Key⚠️立即复制保存Key 只显示一次之后无法再查看开发者门户是管理整个部署的控制台管理用户、查看各厂商数据覆盖度、监控同步运行、配置 Webhooks、管理数据优先级多家设备数据重叠时谁优先等都可以在这完成。第五步发起第一次 API 调用打开http://localhost:8000/docs就能看到交互式 Swagger 文档所有端点都可以在线调试。用刚才的 API Key 发起第一个请求curl http://localhost:8000/api/v1/users \ -H X-Open-Wearables-API-Key: YOUR_API_KEY想让数据更真实仓库提供了种子脚本一键生成测试用户和示例活动数据make seed对应逻辑在 backend/scripts/init/seed_activity_data.py常用命令都在 Makefile 中make help可以查看全部。部署成功后连接你的第一台设备以云厂商为例部署完成后的集成流程如图所示——你的应用调用 Open Wearables 创建用户并获取 OAuth 授权链接用户在厂商侧登录后数据自动回同步之后就能通过统一 Data API 取数操作路径在开发者门户中Add User→ 选择厂商如 Garmin / Oura生成连接链接 → 用户授权后历史数据会自动回填后续增量通过定时同步 Webhook 推送。各厂商支持的数据类型详见 docs/providers/coverage.mdx。统一数据模型把「事件」运动、睡眠和「时序数据」心率、HRV、血氧、体重等分开存储每种数据按用户形成独立序列这也是 API 查询简单直接的原因常见问题排查问题解决方法端口冲突5432/8000/3000被占用时在 compose 中用DB_PORT、API_PORT、FRONTEND_PORT环境变量改端口不确定哪个容器出错docker compose logs -f实时查看全部日志API 迟迟不通首次启动要跑数据库迁移稍等后重试迁移文件位于 backend/migrations/versions/想彻底重来docker compose down -v停掉并清空数据卷更完整的本地开发不用 Docker方式可以参考官方文档 docs/quickstart.mdx。总结你完成了什么现在你已经在自己的服务器上跑起了一个完整的工作流克隆仓库 → 复制两份 .env →docker compose up -d→ 登录门户拿 API Key → 第一次 API 调用成功。接下来可以 连接你的第一台真实设备Garmin / Oura / Whoop 等 在门户注册 Webhook 端点实时接收新数据事件 配置内置 MCP Server让 AI 助手直接回答我上周睡眠质量如何Open Wearables 采用 MIT 协议可自由用于商业与开源项目。祝部署顺利【免费下载链接】open-wearablesSelf-hosted platform to unify wearable health data through one AI-ready API.项目地址: https://gitcode.com/gh_mirrors/op/open-wearables创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考