跳转到主要内容

​
前置条件

开始之前，请确保已安装以下内容：

Docker

版本 20.10 或更高

Docker Compose

版本 1.29 或更高
你可以通过运行 docker --version 和 docker-compose --version 来验证 Docker 是否安装成功。

​
安装步骤

1

克隆仓库

将 Mirobody Health 仓库克隆到本地：
git clone https://github.com/thetahealth/mirobody-health.git
cd mirobody-health
2

配置文件初始化

根据示例文件创建你的配置文件：
cp .env_example .env
cp config.example.yaml config.yaml
快速体验时你可以先使用默认配置；生产环境请参考配置指南。
3

添加 API keys

编辑 config.yaml 填写你的 API keys。OPENROUTER_API_KEY 和 GOOGLE_API_KEY 都是必填：
config.yaml
# AI Provider API Keys - REQUIRED
OPENROUTER_API_KEY: 'your_openrouter_api_key'  # REQUIRED for AI chat/agents
GOOGLE_API_KEY: 'your_google_api_key'  # REQUIRED for file processing (Gemini)

# Optional: Additional AI providers
OPENAI_API_KEY: 'your_openai_api_key'
OPENROUTER_API_KEY 必填，用于 AI 对话与 agent 功能。请在 OpenRouter 获取你的 API key。GOOGLE_API_KEY（Gemini）必填，用于处理 PDF、图片与医疗记录等文件。请在 Google AI Studio 获取你的 API key。
OpenRouter 通过一个 API 提供对多个 LLM provider 的访问；Google Gemini 负责多模态文件处理。
4

使用 Docker 部署

运行部署脚本启动所有服务：
./deploy.sh
这会启动三个服务：
  • Backend API：端口 18080
  • PostgreSQL：端口 5432
  • Redis：端口 6379
等待所有服务启动完成；你会看到日志提示启动成功。
5

验证安装

打开浏览器访问：
http://localhost:18080
你应该能看到 Mirobody Health 的欢迎页面。
6

登录

使用默认 demo 账号或 config.yaml 中配置的账号登录：
[email protected]
777777
登录后你可以：
  • 上传文件：检验报告、医疗记录与健康文档（参见文件处理）
  • 与 AI 对话：基于你的健康数据提问
  • 连接 providers：链接 Garmin、Whoop 等设备（参见使用 Providers）

​
测试 API

服务运行后，你可以测试以下 API endpoints：
验证服务是否在运行：
curl http://localhost:18080/health

​
可用 Endpoints

部署完成后，可用 endpoints 如下：

Web Interface

主 Web 界面与文档

MCP Protocol

面向 AI agents 的 JSON-RPC 2.0 接口

Chat API

AI 对话接口 endpoint

History

会话历史 endpoint

​
Docker 服务

部署包含三个容器化服务：
ServicePortDescription
backend18080FastAPI application server
postgres5432PostgreSQL database
redis6379Redis cache and session store
你可以用以下命令查看任意服务的日志：
docker-compose logs -f backend
docker-compose logs -f postgres
docker-compose logs -f redis

​
常用命令

docker-compose down

docker-compose restart

# All services
docker-compose logs -f

# Specific service
docker-compose logs -f backend

docker-compose down
docker-compose build --no-cache
docker-compose up -d

docker-compose exec postgres psql -U holistic_user -d holistic_db

docker-compose exec redis redis-cli

​
故障排查

如果 18080 端口已被占用，请编辑 config.yaml：
HTTP_PORT: 18081  # Change to an available port
然后重启服务即可。
确保 PostgreSQL 容器在运行：
docker-compose ps postgres
查看数据库日志：
docker-compose logs postgres
确认 Redis 在运行且可访问：
docker-compose exec redis redis-cli ping
正常情况下应返回 PONG。
给脚本增加可执行权限：
chmod +x deploy.sh

​
下一步

现在你已经启动了 Mirobody Health：

配置 Providers

为 Garmin、Whoop 等 providers 配置 OAuth 凭据

浏览 API

了解如何使用 Pulse API 链接用户并获取健康数据

理解架构

了解 Mirobody Health 如何处理并标准化健康数据

添加新 Providers

按照指南集成更多健康设备 Provider
生产环境部署请参考生产环境部署指南，包括安全加固与性能优化建议。