memu-medical 2.0.0

MeMu SDK — Python client for the MeMu medical AI platform (FHIR-ready)

MeMu Python SDK

Python client library for the MeMu medical AI platform.

Installation

pip install -e ./sdk

Quick Start

from memu import MeMuClient, MedicalEntityExtractor

# Option 1: Cognito client_credentials (recommended for server-to-server)
client = MeMuClient(
    base_url="https://your-api.execute-api.us-east-1.amazonaws.com",
    client_id="<cognito-client-id>",
    client_secret="<cognito-client-secret>",
    token_url="https://your-domain.auth.us-east-1.amazoncognito.com/oauth2/token",
)

# Option 2: Pre-obtained Bearer token
client = MeMuClient(
    base_url="https://your-api.execute-api.us-east-1.amazonaws.com",
    token="<access-token>",
)

# Extract medical entities
extractor = MedicalEntityExtractor(client)
result = extractor.extract_medical_entities(
    transcript="Patient takes Lisinopril 10mg daily for hypertension",
)
print(result)

client.close()

Available Services

Class	Method	Description
MedicalEntityExtractor	extract_medical_entities()	Extract medications, diseases, procedures
MedicalEntityExtractorFHIR	extract_medical_entities()	FHIR Bundle output
DrugInteractionChecker	orchestrate_interaction_check()	Check drug-drug interactions
DrugInteractionCheckerFHIR	orchestrate_interaction_check_fhir()	FHIR DetectedIssue output
HCPCSCodeOrchestrator	suggest_hcpcs_code()	Suggest HCPCS codes
HCPCSCodeOrchestratorFHIR	orchestrate_hcpcs_fhir()	FHIR Procedure output
ICD10CodeOrchestrator	suggest_icd10_code()	Suggest ICD-10 codes
ICD10CodeOrchestratorFHIR	orchestrate_icd10_fhir()	FHIR Condition output
MedicalSummarizer	summarize_medical_info()	Summarize clinical notes
MedicalSummarizerFHIR	summarize_medical_info_fhir()	FHIR Composition output
Audio	transcribe_audio_file()	Transcribe audio files
AudioFHIR	transcribe_audio_file()	FHIR DocumentReference output

Async client

AsyncMeMuClient mirrors MeMuClient for asyncio apps (e.g. FastAPI), so long-running submit-and-poll never blocks the event loop:

import asyncio
from memu import AsyncMeMuClient

async def main():
    async with AsyncMeMuClient.from_env() as client:
        result = await client.submit_and_poll(
            "/summarization/summarize_medical_info",
            {"transcript": "…", "medical_records": []},
        )
        print(result)

asyncio.run(main())

Both clients share the same resilience: retries with backoff/Retry-After, idempotency-safe POST (never double-creates a task), single 401 re-auth, and base_url validation.

Running Tests

cd sdk
export MEMU_BASE_URL="https://your-api.execute-api.us-east-1.amazonaws.com"
export MEMU_CLIENT_ID="<cognito-client-id>"
export MEMU_CLIENT_SECRET="<cognito-client-secret>"
export MEMU_TOKEN_URL="https://your-domain.auth.us-east-1.amazoncognito.com/oauth2/token"

python3 -m pytest tests/ -v