如果使用托管 API 密钥和
/v1 接口，请阅读单独的 Cloud 快速开始。本页介绍开源引擎及其运行命令。
A · 作为库使用
两个包，唯一的依赖是 numpy。不需要密钥、网络或数据库，本机也不运行任何模型：解析器是基于 LOINC 的词法索引，而不是 LLM。血脂 指的是一类检查，而不是某一项观测，所以它解析不出结果。这是有意的设计：错误的编码会把两项不同的检查放到同一条趋势线上。
读取厂商导出包不需要任何额外依赖，zipfile 与 xml.etree 都在标准库中：
pip install 'mirobody[parse]' 用于把 PDF、照片或表格变成读数（这一项会调用模型，所以需要密钥），pip install 'mirobody[app]' 用于服务端。上面的用法两者都不需要。（[agent] 是作为库使用的智能体外壳，[test] 是测试套件。）
B · 完整的栈
Postgres + pgvector、服务端与 worker，演示记录已经预先写入。deploy.sh 会拉取应用镜像（其中已包含 LOINC 术语包），并在首次运行时写出带有自动生成密钥的 .env。Docker 方式不需要 Git LFS。在 .env 中设置一个模型密钥，然后用 docker compose up -d 重启服务端与 worker。在服务容器内检查可用的模型功能：
you@mirobody.ai 登录，验证码 111111，不需要邮件服务。SEED_DEMO_DATA 默认开启，两个账号里已经有共 2,019 条读数。如果打算保存真实数据，请在首次启动前把它设为 false，两个账号都不会创建。
demo/upload/ 中有四个文件有意没有预先写入，把其中一个拖到 Data 页面，就会执行实际的文件处理流程。
C · 源码检出
serve 是部署形态：它读取随包分发的配置以及任意 config.{ENV}.yaml 覆盖文件，并要求密钥能持久保存。dev 在同一个进程里运行同一个服务端，配置只存在于内存中，密钥自动生成：
version 字段。数据库需要 pgvector：首次启动时创建的 schema 包含向量列。
dev 提供的是 API，不包括 Web 客户端。 构建好的客户端位于仓库根目录的 frontend/，不在包内，所以源码检出里有，pip install 安装的没有。dev 用于 API、MCP 接口与 agent；需要界面时请用 B。
dev 生成的密钥只在本次运行有效：重启后会话与加密的配置值都会失效。在环境变量中设置 JWT_KEY、CONFIG_ENCRYPTION_KEY 与 LOG_ENCRYPTION_KEY 即可保留。