Skip to content

Sammindinventory/rationale-builder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Enhanced Medical Rationale Builder

This project provides enhanced medical rationale generation services with multiple knowledge sources and AI-powered analysis.

Features

Enhanced Code Lookup Service

  • Multi-source medical code lookup (ICD-10, CPT, RxNorm)
  • AI-powered code context and validation
  • Related codes and clinical context
  • Documentation requirements

Medical Knowledge Service

  • Integration with MedlinePlus, PubMed, and SNOMED CT
  • Evidence-based medical information
  • Clinical guidelines and best practices
  • Research literature support

Enhanced Rationale Service

  • Comprehensive medical rationale generation
  • Multi-source knowledge integration
  • Evidence-based recommendations
  • Safety considerations and alternatives

Setup

  1. Install dependencies:
pip install -r requirements.txt
  1. Set up environment variables in .env:
GOOGLE_API_KEY=your_google_api_key
MEDLINE_API_KEY=your_medline_api_key
PUBMED_API_KEY=your_pubmed_api_key
SNOMED_API_KEY=your_snomed_api_key
  1. Run the service:
uvicorn main:app --reload

Usage

Code Lookup

from services.enhanced.code_lookup_service import EnhancedCodeLookup

code_lookup = EnhancedCodeLookup()
result = await code_lookup.lookup_code("J45.909", "ICD10")

Medical Knowledge

from services.enhanced.medical_knowledge_service import MedicalKnowledgeService

knowledge = MedicalKnowledgeService()
context = await knowledge.get_medical_context("asthma")

Rationale Generation

from services.enhanced.rationale_service import EnhancedRationaleService

rationale = EnhancedRationaleService()
result = await rationale.generate_rationale(
    guideline_id="asthma-guideline-2024",
    request={
        "diagnosis": "Asthma",
        "symptoms": ["wheezing", "shortness of breath"],
        "history": "Patient has history of asthma"
    }
)

API Endpoints

POST /api/v1/rationale

Generate enhanced medical rationale

Request body:

{
    "guideline_id": "string",
    "request": {
        "diagnosis": "string",
        "symptoms": ["string"],
        "history": "string",
        "codes": {
            "icd10": ["string"],
            "cpt": ["string"],
            "rxnorm": ["string"]
        }
    }
}

Response:

{
    "clinical_assessment": {
        "primary_diagnosis": "string",
        "medical_history": "string",
        "symptoms": ["string"]
    },
    "treatment_rationale": {
        "recommendations": ["string"],
        "confidence_level": "string",
        "supporting_evidence": ["string"]
    },
    "alternative_options": [{
        "treatment": "string",
        "pros": ["string"],
        "cons": ["string"]
    }],
    "safety_considerations": {
        "risks": ["string"],
        "contraindications": ["string"],
        "monitoring": ["string"]
    },
    "decision_support": {
        "recommendation": "string",
        "reasoning": "string",
        "evidence_quality": "string"
    }
}

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published