Repolode
thetahealth

thetahealth/mirobody

Um mecanismo de dados de saúde com IA e hospedagem própria que padroniza exames laboratoriais, dados de wearables e arquivos genéticos em um único registro rastreável, com servidor MCP.

Estrelas
1,382
Forks
242
Issues abertas
2
Último commit
ontem

O que é?

O Mirobody reúne dados de saúde dispersos, como PDFs e fotos de laudos laboratoriais, exportações do Apple Health, dados do Garmin, Oura e Whoop, além de arquivos genéticos do 23andMe ou VCF, e associa nomes de exames e unidades a códigos padronizados. O mecanismo resolve nomes diferentes para o mesmo exame, como A1c, HbA1c e Glycated Hemoglobin, usando um único código LOINC, sem conexão com a internet, e converte as unidades para UCUM. Cada medição mantém um link para o arquivo de origem e a página de onde veio.

Você pode executar o app web completo no GitHub Codespaces com sua própria chave de API de modelo ou implantá-lo com Docker. Um perfil do Docker executa o llama.cpp localmente para que o app, os registros e os modelos permaneçam na sua própria máquina, sem precisar de uma chave de API. Também há instruções para instalação nativa no Debian ou Ubuntu.

O pacote pode ser usado de forma independente via pip para resolver nomes e unidades, e o app disponibiliza sete ferramentas MCP para que agentes como Claude Code, Codex ou Cursor consultem o registro da pessoa conectada.

Recursos principais

  • 01Associa nomes de exames laboratoriais em vários idiomas a um único código LOINC, sem conexão com a internet.
  • 02Converte unidades para UCUM com verificações dimensionais.
  • 03Importa PDFs, fotos, planilhas e exportações do Apple Health em um único histórico.
  • 04Vincula cada medição ao arquivo de origem e à página correspondente.
  • 05Funciona totalmente local com Docker e llama.cpp, sem exigir uma chave de API de modelo.
  • 06Disponibiliza ferramentas MCP para consultar o registro da pessoa conectada.

Casos de uso

  • Acompanhar um indicador de saúde, como o colesterol, em laudos de diferentes laboratórios.
  • Consolidar dados de wearables e genéticos junto aos registros médicos em um repositório privado e hospedado por conta própria.
  • Dar a um agente de programação ou chat acesso estruturado a um registro pessoal de saúde via MCP.
  • Padronizar nomes de exames laboratoriais e unidades em um app de saúde ou pipeline de dados usando o pacote Python.

Início rápido

  1. 1

    Instale o uv (consulte o guia de instalação do uv) e execute o resolver com um único comando

    uvx --python 3.12 mirobody resolve "LDL cholesterol" 血红蛋白 ヘモグロビン "Total Kolesterol" 血脂
  2. 2

    Para executar o app completo localmente com Docker, clone o repositório

    git clone --depth 1 https://github.com/thetahealth/mirobody.git && cd mirobody
  3. 3

    Inicie a stack local com Docker e o perfil de modelo CPU

    COMPOSE_PROFILES=local-cpu ./deploy.sh

Antes de usar

  • O app completo local precisa de cerca de 16 GB de memória e de uma conexão de rede para o primeiro download das imagens e dos pesos do modelo.
  • As respostas com CPU local podem levar alguns minutos; não é necessário ter GPU, mas com uma GPU elas são mais rápidas.
  • A instalação sem Docker oferece suporte apenas a Debian ou Ubuntu e exige sua própria chave de API do modelo para gerar respostas.
  • A opção com codespace envia documentos e perguntas ao fornecedor do modelo escolhido.

Tópicos

Perguntas frequentes

O que é mirobody?
Um mecanismo de dados de saúde com IA e hospedagem própria que padroniza exames laboratoriais, dados de wearables e arquivos genéticos em um único registro rastreável, com servidor MCP. O Mirobody reúne dados de saúde dispersos, como PDFs e fotos de laudos laboratoriais, exportações do Apple Health, dados do Garmin, Oura e Whoop, além de arquivos genéticos do 23andMe ou VCF, e associa nomes de exames e unidades a códigos padronizados. O mecanismo resolve nomes diferentes para o mesmo exame, como A1c, HbA1c e Glycated Hemoglobin, usando um único código LOINC, sem conexão com a internet, e converte as unidades para UCUM. Cada medição mantém um link para o arquivo de origem e a página de onde veio.
mirobody é gratuito? Qual é a licença?
mirobody é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
mirobody ainda é mantido?
Manutenção ativa. O último commit de mirobody foi em 19 de out. de 2026.
Para que posso usar mirobody?
Acompanhar um indicador de saúde, como o colesterol, em laudos de diferentes laboratórios. Consolidar dados de wearables e genéticos junto aos registros médicos em um repositório privado e hospedado por conta própria. Dar a um agente de programação ou chat acesso estruturado a um registro pessoal de saúde via MCP. Padronizar nomes de exames laboratoriais e unidades em um app de saúde ou pipeline de dados usando o pacote Python.
Como instalar mirobody?
Instale o uv (consulte o guia de instalação do uv) e execute o resolver com um único comando: uvx --python 3.12 mirobody resolve "LDL cholesterol" 血红蛋白 ヘモグロビン "Total Kolesterol" 血脂 Para executar o app completo localmente com Docker, clone o repositório: git clone --depth 1 https://github.com/thetahealth/mirobody.git && cd mirobody Inicie a stack local com Docker e o perfil de modelo CPU: COMPOSE_PROFILES=local-cpu ./deploy.sh
Onde consigo mirobody?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/thetahealth/mirobody

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados