Skip to main content

MedOrqis — Medical AI Skills Ecosystem (v2.1.1)

Live Interactive Catalog DOI Skills CLI npm version Verification: 36/36 Passed (100%) GitHub CI License: Apache-2.0

MedOrqis is an open-source, evidence-grounded, cross-platform ecosystem of 24 specialized clinical AI skills, 12 deterministic zero-token clinical calculators & safety engines, and multi-platform adapters (Skills CLI, Claude Code, Gemini CLI, Model Context Protocol, and OpenAI).

Built with an evidence-first, patient-safety-first architecture, MedOrqis eliminates medical hallucination risks in high-stakes clinical calculations by executing arithmetic, unit conversions, PHI scrubbing, negation parsing, and drug interaction screenings through a local, deterministic Python core with zero LLM API token overhead.


⚡ 1-Minute Quick Start & Integration Options

🛠️ Option 1: One-Command Fleet Install (Skills CLI)

Install all 24 skills directly into your active coding agent workspace (Claude Code, Cursor, Antigravity, OpenCode, Codex):

# Install the complete MedOrqis ecosystem (all 24 skills)
npx skills add seotarek/MedOrqis

# Or install specific clinical skills:
npx skills add seotarek/MedOrqis --skill emergency-triage-redflags
npx skills add seotarek/MedOrqis --skill pharmacology-dosing-interactions
npx skills add seotarek/MedOrqis --skill pediatrics-neonatology

⭐ Support Open-Source Clinical AI: If MedOrqis helps your workflow or coding agents, please give the repo a Star on GitHub — it helps the project reach more clinicians and medical AI engineers!


📦 Option 2: NPX & NPM Interactive Terminal Package (medorqis)

Explore the catalog and copy prompts directly in your terminal:

# Run interactive CLI browser
npx medorqis

# List all 24 skills grouped by safety tier
npx medorqis list

# Print copyable Universal AI Prompt for web chat models
npx medorqis prompt

# Print MCP configuration JSON block
npx medorqis mcp

Or install globally or as a project dependency:

npm install -g medorqis
# or in Node.js apps:
npm install medorqis

⚡ Option 3: Universal AI Model Prompting (Zero Install — Any Model)

You do not need to install anything or run code to use MedOrqis with LLMs! You can send the repository link and prompt directly to ChatGPT (with web access), Claude 3.5 Sonnet, Google Gemini, Cursor, Grok, or Antigravity:

Copy & Paste into any AI model:

Read the open-source clinical AI skills ecosystem MedOrqis at:
https://github.com/seotarek/MedOrqis (Web catalog: https://seotarek.github.io/MedOrqis/)

You are now operating under MedOrqis clinical governance rules (v2.1.1):
1. Enforce zero-hallucination deterministic standards for all medical risk scores and formulas (CHA2DS2-VA ESC 2024, CKD-EPI 2021, Bedside Schwartz, Cockcroft-Gault, Wells DVT/PE, CURB-65, HAS-BLED, NEWS2, Pediatric Dose Capping).
2. Epistemic provenance: Never recommend high-risk interventions based on unconfirmed model hypotheses.
3. Missing Age Gatekeeper: If patient age is unrecorded, do NOT assume a default adult age (30); immediately flag SAFE_ABSTENTION_DATA_DEFICIT.
4. Sentinel Emergency Red Flags: Immediate emergency redirection on acute stroke (FAST), ACS crushing chest pain, anaphylaxis, septic shock, or anticoagulation + active bleeding.
5. Provide evidence-grounded differential diagnosis, drug interaction screening, and red-flag triage across all 24 MedOrqis clinical domains.

Please summarize your activated clinical skills and await clinical input.

🔌 Option 4: Model Context Protocol (MCP Server)

Run the local MCP stdio server:

python3 mcp_server/medorqis_mcp_server.py

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "medorqis": {
      "command": "python3",
      "args": ["/path/to/MedOrqis/mcp_server/medorqis_mcp_server.py"]
    }
  }
}

🐍 Option 5: Local Python Developer Setup

git clone https://github.com/seotarek/MedOrqis.git
cd MedOrqis
python3 -m pip install -e .

🧮 Pure Deterministic Clinical Calculators (core/clinical_calculators.py)

All medical calculations in MedOrqis execute with zero LLM API token overhead and strict mathematical determinism via pure Python functions in core/clinical_calculators.py:

# Clinical Calculator Function Name Clinical Guideline & Standard Target Population Safety Gate & Boundary Enforcement
1 CHA₂DS₂-VA calculate_cha2ds2_va_esc2024 ESC Guidelines 2024 (Sex-Neutral) Adults ($\ge 18\text{y}$) with AF Refuses if Age missing (SAFE_ABSTENTION_DATA_DEFICIT). Removes 1-point female bias.
2 CHA₂DS₂-VASc calculate_cha2ds2_vasc_aha2023 ACC/AHA/ACCP/HRS 2023 Adults ($\ge 18\text{y}$) with AF Historical comparative baseline for US guidelines ($+1$ for female sex).
3 CKD-EPI 2021 calculate_ckd_epi_2021_egfr NKF-ASN Task Force / NEJM 2021 Adults ($\ge 18\text{y}$) Race-free adult eGFR formula. Hard Refusal if Age $< 18$ years (SAFE_REFUSAL_PEDIATRIC).
4 Bedside Schwartz calculate_bedside_schwartz_egfr Schwartz GJ et al. (JASN 2009) Pediatrics ($< 18\text{y}$) Height-based eGFR ($0.413 \times \text{Ht}/\text{SCr}$). Hard Refusal if Age $\ge 18$ years (SAFE_REFUSAL_ADULT).
5 Cockcroft-Gault calculate_cockcroft_gault_crcl FDA Renal Dosing Standards Adults ($\ge 18\text{y}$) Automatically calculates IBW and Adjusted Body Weight (AdjBW $0.4$) if BMI $\ge 30$.
6 HAS-BLED calculate_has_bled_score Pisters R et al. (Chest 2010) Adults on Anticoagulation Flags High Bleeding Risk ($\ge 3$); warns against unmonitored DOAC initiation.
7 CURB-65 calculate_curb65_score British Thoracic Society (BTS) Adults with CAP Stratifies 30-day mortality risk (Outpatient vs Inpatient vs ICU admission).
8 NEWS2 calculate_news2_score Royal College of Physicians (2017) Acute Inpatient Care Physiological aggregate triage across 6 vital signs; automated sepsis escalation.
9 Wells DVT Criteria calculate_wells_dvt_score Wells PS et al. (NEJM 2003) Suspected DVT Pre-test probability (Unlikely vs Likely); dictates D-dimer vs Compression Ultrasound.
10 Wells PE Criteria calculate_wells_pe_score Wells PS et al. (Ann Intern Med 2001) Suspected PE Pre-test probability (Unlikely vs Likely); dictates D-dimer vs CT Pulmonary Angiography.

(Auxiliary dosing & safety engines: calculate_pediatric_weight_dose & calculate_mosteller_bsa in core/clinical_calculators.py, and Contraindicated DDI Screening in core/safety_guardrails.py).


🏥 The 24-Skill Risk-Stratified Taxonomy

Tier 1: Governance, Research & Operations (Class A)

  • medorqis-orchestrator: Context envelope routing and conflict resolution.
  • ebm-research-biostatistics: PICO, CASP, RoB-2 appraisal, and GRADE certainty.
  • medical-documentation-translation: SOAP, SBAR, and BiDi multilingual medical translation.
  • healthcare-ops-telemedicine-ehr: HL7 FHIR mapping and telemedicine intake.
  • health-cybersecurity-privacy: PHI scrubbing and prompt injection defense.
  • public-health-epidemiology: Screening metrics (sens/spec) and IPC protocols.

Tier 2: Diagnostic & Chronic Care Support (Class B)

  • differential-diagnosis-cds: VINDICATE differential framework.
  • laboratory-medicine-pathology: Critical panic values and LOINC mapping.
  • radiology-medical-imaging: ACR Appropriateness Criteria and radiation safety.
  • internal-medicine-chronic: Multi-morbidity chronic disease care plans.
  • infectious-diseases-stewardship: Antimicrobial stewardship and resistance awareness.
  • nursing-clinical-care: NEWS2 early warning score and Braden scale.
  • clinical-nutrition-dietetics: Caloric requirements and food-drug interactions.
  • rehabilitation-physical-therapy: Post-op and stroke rehab protocols.

Tier 3: High-Risk, Emergency & Vulnerable Populations (Class C)

  • emergency-triage-redflags: ABCDE primary survey and emergency redirection.
  • clinical-safety-auditor: Pre-output verification and safety gate check.
  • pharmacology-dosing-interactions: Renal/hepatic adjustments and DDI checks.
  • clinical-toxicology-overdose: Toxidromes, antidotes, and Poison Control escalation.
  • pediatrics-neonatology: Weight-based dose capping and pediatric safety.
  • obstetrics-gynecology: Maternal-fetal safety and pre-eclampsia triage.
  • geriatrics-polypharmacy: 2023 Beers Criteria and STOPP/START.
  • mental-health-psychiatry: Suicide crisis escalation and psychotropic monitoring.
  • perioperative-surgical-care: RCRI pre-op risk and anticoagulation bridging.
  • oncology-palliative-care: Oncologic emergencies and palliative pain control.

🌐 Multilingual & Dialect Regression Benchmark

MedOrqis includes a deterministic natural language processing normalizer verified across 126 curated synthetic test fixtures:

  • 100 Syntactic Negation Sentences: Handcrafted fixtures verifying regex boundary detection and clause-stop logic across 8 dialects and languages: Modern Standard Arabic (ar-MSA), Egyptian (ar-EG), Gulf (ar-GULF), Levantine (ar-LEV), Maghrebi (ar-MAG), English (en-US/GB), French (fr-FR), and Spanish (es-ES).
  • 10 BiDi & Unit Token Strings: Numerical and unit strings verifying bidirectional layout preservation (e.g. Arabic RTL mixing English numbers/units like "500 mg").
  • 16 Trade Brand-to-INN Mappings: Lookup fixtures mapping regional commercial trade brand names to generic International Nonproprietary Names (e.g. Panadol $\to$ Paracetamol).

🧪 Automated Verification & Provenance

Execute cryptographic file integrity verification and the harmonized clinical test suite (all 36 unit, safety, multilingual, and adapter tests):

# 1. Verify SHA-256 cryptographic fingerprints across all 45 modules
python3 core/integrity_manifest.py --verify

# 2. Execute the harmonized clinical test suite
python3 tests/run_all_tests.py

This automatically verifies:

  1. tests/unit/test_clinical_calculators.py: Boundary and formula correctness for all 12 clinical engines.
  2. tests/safety/test_safety_and_provenance.py: Epistemic provenance gates, missing age gatekeeper, sentinel emergency red-flags, and contraindicated DDIs.
  3. tests/multilingual/test_multilingual_benchmark.py: Negation preservation, BiDi unit fidelity, and brand-to-INN mapping across 126 test cases.
  4. tests/platform_adapters/test_security_and_adapters.py: SHA-256 cryptographic file integrity manifest, PHI scrubbing, prompt injection defense, and MCP JSON-RPC protocol.

Artifacts generated:


⚖️ Governance & Regulatory Disclaimer

MedOrqis is an open-source clinical reference architecture and research framework. It is NOT a certified Medical Device (SaMD) and does not autonomously diagnose or prescribe. Clinical Decision Support outputs must always be reviewed by a licensed healthcare professional. See MEDICAL_DISCLAIMER.md and SAFETY_AND_GOVERNANCE.md.


📚 Academic Citation & Persistent DOI

If you use MedOrqis in clinical informatics, medical AI research, or clinical decision support development, please cite our persistent Zenodo repository DOI:

@software{mohamed_2026_medorqis,
  author       = {Mohamed, Tarek},
  title        = {MedOrqis: Medical AI Skills Ecosystem with Deterministic Safety Guardrails & Zero-Token Calculators},
  month        = nov,
  year         = 2026,
  publisher    = {Zenodo},
  version      = {v2.1.1},
  doi          = {10.5281/zenodo.23937802},
  url          = {https://doi.org/10.5281/zenodo.23937802}
}

📜 License

Licensed under the Apache License, Version 2.0. Medical vocabularies and guidelines are attributed in DATA_LICENSES_AND_ATTRIBUTIONS.md.

Metadata

Release files for medorqis 2.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for medorqis 2.1.1
File Size Uploaded Provenance Actions
medorqis-2.1.1.tar.gz 49.9 kB Without provenance Details for medorqis-2.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for medorqis 2.1.1
File Interpreter ABI Platform Actions
medorqis-2.1.1-py3-none-any.whl Python 3 none any Details for medorqis-2.1.1-py3-none-any.whl

Total release size: 101.4 kB

Release files / medorqis-2.1.1.tar.gz

Download URL medorqis-2.1.1.tar.gz
Size 49.9 kB
Tags Source
SHA-256 checksum
How to use checksums
4b5c81afca2c7e0241814394480f3abd4f6a11364f7757d06bffdd68ad500995
BLAKE2b-256 checksum
How to use checksums
61a8383098e96088091dbedd8a4dc85f107c66167a24d721e6a2a17e87b352e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / medorqis-2.1.1-py3-none-any.whl

Download URL medorqis-2.1.1-py3-none-any.whl
Size 51.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1d2a43a2f97fb29e0a20b95a9cf38b83c928fbb94693010d361c370a8b3f9d9d
BLAKE2b-256 checksum
How to use checksums
224acd2e843c5178b006035a72cd7dc79e4420d89bd9852523b389ad1654c3f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for medorqis 2.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page