thetahealth/mirobody

어떤 프로젝트인가요?

핵심 기능

• 01여러 언어의 검사명을 오프라인에서 하나의 LOINC 코드로 매핑합니다.
• 02차원 검사를 적용해 단위를 UCUM으로 변환합니다.
• 03PDF, 사진, 스프레드시트, Apple Health 내보내기 파일을 하나의 기록으로 가져옵니다.
• 04각 측정값을 원본 파일과 페이지에 연결합니다.
• 05모델 API 키 없이 Docker와 llama.cpp로 완전히 로컬에서 실행합니다.
• 06로그인한 사용자의 기록을 조회할 수 있는 MCP 도구를 제공합니다.

활용 사례

• 서로 다른 검사 기관의 결과 보고서에서 콜레스테롤 같은 건강 지표 하나를 추적합니다.
• 웨어러블 및 유전 데이터를 의료 기록과 함께 비공개 셀프 호스팅 저장소에 통합합니다.
• MCP를 통해 코딩 에이전트나 채팅 에이전트가 개인 건강 기록에 구조화된 방식으로 접근하도록 합니다.
• Python 패키지를 사용해 건강 앱이나 데이터 파이프라인의 검사명과 단위를 표준화합니다.

빠른 시작

1. 1

   uv 설치 가이드에 따라 uv를 설치한 다음, 명령어 하나로 resolver를 실행합니다

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

   Docker로 앱 전체를 로컬에서 실행하려면 저장소를 클론합니다

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

   Docker와 CPU 모델 프로필을 사용해 로컬 스택을 시작합니다

   COMPOSE_PROFILES=local-cpu ./deploy.sh

사용 전 알아둘 점

• !앱 전체를 로컬에서 실행하려면 약 16 GB의 메모리가 필요하며, 이미지와 모델 가중치를 처음 다운로드할 때 네트워크 연결이 필요합니다.
• !로컬 CPU로 답변을 생성하는 데 몇 분이 걸릴 수 있습니다. GPU는 필요하지 않지만 있으면 더 빠릅니다.
• !Docker를 사용하지 않는 설치 방법은 Debian 또는 Ubuntu만 지원하며, 답변을 생성하려면 자체 모델 API 키가 필요합니다.
• !codespace 방식에서는 문서와 질문이 선택한 모델 공급업체로 전송됩니다.

토픽

자주 묻는 질문

mirobody은(는) 무엇인가요?

검사 결과, 웨어러블 데이터, 유전 파일을 추적 가능한 기록으로 표준화하는 셀프 호스팅 AI 건강 데이터 엔진 Mirobody는 검사 결과 PDF와 사진, Apple Health 내보내기 파일, Garmin·Oura·Whoop 데이터, 23andMe 또는 VCF 유전 파일처럼 여러 곳에 흩어진 건강 데이터를 모으고, 검사명과 단위를 표준 코드에 매핑합니다. A1c, HbA1c, Glycated Hemoglobin처럼 같은 검사를 가리키는 다양한 이름을 오프라인에서 하나의 LOINC 코드로 통합하고, 단위는 UCUM으로 변환합니다. 각 측정값에는 해당 값이 담긴 원본 파일과 페이지로 연결되는 링크가 포함됩니다.

mirobody은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mirobody은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mirobody은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mirobody의 마지막 커밋은 2026년 10월 19일입니다.

mirobody은(는) 어디에 사용할 수 있나요?

서로 다른 검사 기관의 결과 보고서에서 콜레스테롤 같은 건강 지표 하나를 추적합니다. 웨어러블 및 유전 데이터를 의료 기록과 함께 비공개 셀프 호스팅 저장소에 통합합니다. MCP를 통해 코딩 에이전트나 채팅 에이전트가 개인 건강 기록에 구조화된 방식으로 접근하도록 합니다. Python 패키지를 사용해 건강 앱이나 데이터 파이프라인의 검사명과 단위를 표준화합니다.

mirobody는 어떻게 설치하나요?

uv 설치 가이드에 따라 uv를 설치한 다음, 명령어 하나로 resolver를 실행합니다: uvx --python 3.12 mirobody resolve "LDL cholesterol" 血红蛋白 ヘモグロビン "Total Kolesterol" 血脂 Docker로 앱 전체를 로컬에서 실행하려면 저장소를 클론합니다: git clone --depth 1 https://github.com/thetahealth/mirobody.git && cd mirobody Docker와 CPU 모델 프로필을 사용해 로컬 스택을 시작합니다: COMPOSE_PROFILES=local-cpu ./deploy.sh

mirobody은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/thetahealth/mirobody