前置条件
开始之前，请确保您已安装以下内容：
您可以通过运行 docker --version 和 docker-compose --version 来验证 Docker 是否安装成功。
安装步骤
克隆仓库
将 Mirobody Health 仓库克隆到本地机器：git clone https://github.com/thetahealth/mirobody-health.git
cd mirobody-health
初始化配置文件
创建您的 .env 文件和配置文件：cp .env.example .env
cp config.yaml config.localdb.yaml
ENV 变量告诉系统使用哪个配置文件。ENV=localdb 将加载 config.localdb.yaml。
设置环境变量
编辑 .env 设置您的配置文件：这会告诉系统使用 config.localdb.yaml 进行配置。 添加 API 密钥并配置 Agent
创建 config.localdb.yaml 并添加至少一个 LLM API 密钥：# ============ LLM API 密钥 (至少需要一个) ============
GOOGLE_API_KEY: '' # 用于 Gemini 模型
OPENAI_API_KEY: '' # 用于 GPT 模型
OPENROUTER_API_KEY: '' # 用于通过 OpenRouter 访问 Claude、DeepSeek 等模型
# ============ Agent 配置 ============
# MCP 工具目录
MCP_TOOL_DIRS:
- mirobody/pub/tools
- mirobody/pub/tools_health
# MCP 资源目录
MCP_RESOURCE_DIRS:
- mirobody/pub/resources
# Agent 目录
AGENT_DIRS:
- mirobody/pub/agents
Mirobody Health 包含两种 Agent 类型：
- DeepAgent (基于 LangChain): 最适合处理复杂任务、文件操作、多步骤规划
- BaselineAgent (原生 Gemini): 最适合简单对话、轻量级 MCP 集成
有关 Agent 能力和配置的详情，请参阅 工具概览。 配置提供商 (可选)
如果您想连接 Garmin 或 Whoop 等可穿戴设备，请添加它们的 OAuth 凭据：# 提供商 OAuth 凭据 (可选)
GARMIN_CLIENT_ID: ''
GARMIN_CLIENT_SECRET: ''
GARMIN_REDIRECT_URI: ''
WHOOP_CLIENT_ID: ''
WHOOP_CLIENT_SECRET: ''
WHOOP_REDIRECT_URI: ''
使用 Docker 部署
运行部署脚本启动所有服务：这将启动三个服务：
- 后端 API，端口 18080
- PostgreSQL 数据库，端口 5432
- Redis 缓存，端口 6379
等待所有服务启动。您应该能看到表示启动成功的日志。
验证安装
打开浏览器并导航至：您应该能看到 Mirobody Health 的欢迎页面。 登录
使用默认的演示账号或在 config.yaml 中设置的账号登录。登录后，您可以：
- 上传文件: 化验单、医疗记录、健康文档（参见 文件处理）
- 与 AI 对话: 针对您的健康数据提问
- 连接提供商: 绑定 Garmin、Whoop 和其他设备（参见 使用提供商）
测试 API
服务运行后，您可以测试 API 端点：
验证服务器是否正在运行：curl http://localhost:18080/health
获取可用的健康提供商：curl http://localhost:18080/api/v1/pulse/providers
测试 MCP 协议端点：curl -X POST http://localhost:18080/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'
可用端点
部署后，以下端点可用：
Docker 服务
部署包含三个容器化服务：
| 服务 | 端口 | 描述 |
|---|
| backend | 18080 | FastAPI 应用程序服务器 |
| postgres | 5432 | PostgreSQL 数据库 |
| redis | 6379 | Redis 缓存和会话存储 |
您可以使用以下命令查看任何服务的日志：docker-compose logs -f backend
docker-compose logs -f postgres
docker-compose logs -f redis
常用命令
# 所有服务
docker-compose logs -f
# 特定服务
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 # 更改为可用端口
确保 PostgreSQL 容器正在运行：docker-compose ps postgres
docker-compose logs postgres
验证 Redis 正在运行且可访问：docker-compose exec redis redis-cli ping
PONG。
下一步
现在您已运行了 Mirobody Health：
