Concept Explainer#

Explains medical concepts using everyday analogies.

Features#

• Analogy generation
• Concept simplification
• Multiple explanation levels
• Visual description support

Parameters#

ParameterTypeDefaultRequiredDescription--concept, -cstring-YesMedical concept to explain--audience, -astringpatientNoTarget audience (child, patient, student)--list, -lflag-NoList all available concepts--output, -ostring-NoOutput JSON file path

Usage#

bash

# Explain thrombosis to a patient
python scripts/main.py --concept "thrombosis"

# Explain to a child
python scripts/main.py --concept "immune system" --audience child

# Explain to a medical student
python scripts/main.py --concept "antibiotic resistance" --audience student

# List all available concepts
python scripts/main.py --list

Output Format#

json

{
  "explanation": "string",
  "analogy": "string",
  "key_points": ["string"]
}

Risk Assessment#

Risk IndicatorAssessmentLevelCode ExecutionPython/R scripts executed locallyMediumNetwork AccessNo external API callsLowFile System AccessRead input files, write output filesMediumInstruction TamperingStandard prompt guidelinesLowData ExposureOutput files saved to workspaceLow

Security Checklist#

• No hardcoded credentials or API keys
• No unauthorized file system access (../)
• Output does not expose sensitive information
• Prompt injection protections in place
• Input file paths validated (no ../ traversal)
• Output directory restricted to workspace
• Script execution in sandboxed environment
• Error messages sanitized (no stack traces exposed)
• Dependencies audited

Prerequisites#

No additional Python packages required.

Evaluation Criteria#

Success Metrics#

• Successfully executes main functionality
• Output meets quality standards
• Handles edge cases gracefully
• Performance is acceptable

Test Cases#

1. Basic Functionality: Standard input → Expected output
2. Edge Case: Invalid input → Graceful error handling
3. Performance: Large dataset → Acceptable processing time

Lifecycle Status#

• Current Stage: Draft

• Next Review Date: 2026-03-06

• Known Issues: None

• Planned Improvements:

  • Performance optimization
  • Additional feature support