跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.mirobody.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
前置条件

Docker + Compose

Docker Desktop 或 docker + docker compose

Git

用于克隆仓库

Git LFS

用于拉取 fhir_concept_graph.bin 等二进制资产
环境自检：
docker --version
docker compose version
git --version
git lfs version
Git LFS 安装：macOS brew install git-lfs，Linux apt install git-lfs；安装后跑一次 git lfs install 完成初始化。

​
一键部署

1

克隆仓库

git clone https://github.com/thetahealth/mirobody.git
cd mirobody
2

运行部署脚本

./deploy.sh
脚本会自动完成：
  • 生成 .env（含 ENV=localdb 和新鲜的 CONFIG_ENCRYPTION_KEY）
  • 创建默认 config.localdb.yaml
  • 构建 Docker 镜像
  • 启动 Postgres、Redis 和 Mirobody 后端
看到后端日志 Uvicorn running on http://0.0.0.0:18080 即代表启动完成。
3

至少配置一个 LLM API Key

打开 config.localdb.yaml，在以下选项里至少填一个：
config.localdb.yaml
# DeepAgent（默认 Agent）必需
OPENROUTER_API_KEY: 'sk-or-...'

# 可选替代项
OPENAI_API_KEY: 'sk-...'
GOOGLE_API_KEY: '...'
ANTHROPIC_API_KEY: 'sk-ant-...'
OPENROUTER_API_KEY 是默认 DeepAgent 必需的。可在 openrouter.ai/keys 申请。所有密钥在 Mirobody 首次加载时会用 CONFIG_ENCRYPTION_KEY 自动加密。
Mirobody 内置三种 Agent：
  • DeepAgent —— 单模型工具编排，默认选择
  • MixAgent —— 两阶段融合（编排者 + 回复者），平衡成本与质量
  • BaselineAgent —— 不调工具的直连 LLM 对话
切换方式见 工具概览。
4

（可选）配置 Providers 与 OAuth

需要接入可穿戴设备或启用 Google / Apple 登录时，在 config.localdb.yaml 中补上对应凭据：
# 可穿戴设备
GARMIN_CLIENT_ID: ''
GARMIN_CLIENT_SECRET: ''

WHOOP_CLIENT_ID: ''
WHOOP_CLIENT_SECRET: ''

# 第三方登录
GOOGLE_OAUTH_CLIENT_ID: ''
GOOGLE_OAUTH_CLIENT_SECRET: ''
完整参考：配置。
5

打开本地 Web 应用

访问 http://localhost:18080，用预置 demo 账号登录：
demo1@mirobody.ai
777777
其他预置账号（demo2@mirobody.ai、demo3@mirobody.ai）默认同密码 —— 详见 config.localdb.yaml 中的 EMAIL_PREDEFINE_CODES。登录后即可：
  • 上传文件 —— 化验单、病历、照片、音频（参见 文件处理）
  • 与 Agent 对话 —— 自然语言提问你的数据
  • 关联 Provider —— Garmin、Whoop、Oura、Renpho、Apple Health 等（参见 使用 Providers）
6

（可选）使用官方托管客户端

想要更精致的前端？直接访问 https://mirobody.ai —— Theta 官方托管的 Web 客户端，连接你本机的后端服务。
数据流仍然完全在你本机：托管客户端只是 UI，会直接调用你本地的 API。在客户端设置里填上你的后端地址即可。

​
验证 API

curl http://localhost:18080/health

​
各端点

Web 应用

本地 UI、文件上传、对话

MCP 服务器（本地）

给 Claude Desktop / Cursor 用

Chat API

OpenAI 兼容的对话端点

History API

会话历史
需要让 ChatGPT Apps 等远程客户端访问，设置 MCP_PUBLIC_URL=https://yourdomain.com 把 MCP 服务器公开到 HTTPS —— 详见 ChatGPT Apps。

​
Docker 服务

服务端口说明
mirobody18080FastAPI 应用、MCP 服务、图表渲染器
pg5432内置 pgvector 的 PostgreSQL
redis6379缓存与会话存储
查看日志：
docker compose logs -f mirobody
docker compose logs -f pg
docker compose logs -f redis

​
常用命令

docker compose down

docker compose restart

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

docker compose exec pg psql -U mirobody -d mirobody

docker compose exec redis redis-cli

​
故障排查

修改 config.localdb.yaml 里的 HTTP_PORT：
HTTP_PORT: 18081
然后 docker compose restart mirobody。
docker compose ps pg
docker compose logs pg

docker compose exec redis redis-cli ping
应返回 PONG。
chmod +x deploy.sh
多半是 OPENROUTER_API_KEY 缺失或无效。补上后重启服务即可。

​
下一步

配置 Providers

给 Garmin、Whoop、Oura、Renpho 等配置 OAuth 凭据

探索 API

Pulse、Chat、MCP 端点

理解架构

数据如何从设备走到你的屏幕

接入新 Provider

把新的可穿戴或数据源接进来
生产部署请参见 生产部署，含安全加固与性能调优。