openclinical-ai

<p align="center"> <a href="https://huggingface.co/bclermo/openclinical-ai"><img src="https://img.shields.io/badge/%F0%9F%A4%97-Hugging%20Face%20Model-FFD21E?style=flat-square" alt="Hugging Face Model"></a> <a href="https://huggingface.co/spaces/bclermo/openclinical-ai"><img src="https://img.shields.io/badge/%F0%9F%9A%80-Hugging%20Face%20Space-FF6B6B?style=flat-square" alt="Hugging Face Space"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License"></a> <a href="https://github.com/simpliibarrii-crypto/openclinical-ai/releases"><img src="https://img.shields.io/github/v/release/simpliibarrii-crypto/openclinical-ai?style=flat-square" alt="Release"></a> <a href="https://github.com/simpliibarrii-crypto/openclinical-ai/actions"><img src="https://img.shields.io/github/actions/workflow/status/simpliibarrii-crypto/openclinical-ai/ci-python.yml?style=flat-square&label=CI" alt="CI"></a> <a href="CODE_OF_CONDUCT.md"><img src="https://img.shields.io/badge/Contributor%20Covenant-2.0-purple?style=flat-square" alt="Code of Conduct"></a> </p>

OpenClinical AI

<p align="center"> <img src="assets/openclinical-logo.svg" alt="OpenClinical AI Logo" width="200" height="200" /> </p> <p align="center"> **The sovereign, Canadian-built deployment substrate for biology AI and clinical AI — accessible to every healthcare system, regardless of geography or budget.** </p> <p align="center"> <strong>Built for PSWs, nurses, doctors, researchers, and patients. Deployed at Gary J Armstrong Retirement Home (Ottawa) and scaling across Ontario.</strong> </p> <p align="center"> <a href="https://github.com/simpliibarrii-crypto/openclinical-ai"><img alt="OpenClinical AI" src="https://img.shields.io/badge/Canadian-Clinical_AI-8B0000?style=for-the-badge&labelColor=dee2e6&color=dee2e6"></a> <a href="https://github.com/simpliibarrii-crypto/raven-ai"><img alt="Raven Clinical Layer" src="https://img.shields.io/badge/Raven-Clinical_Layer-C8102E?style=for-the-badge&labelColor=05060A"></a> <img alt="Stars" src="https://img.shields.io/github/stars/simpliibarrii-crypto/openclinical-ai?style=for-the-badge&color=goldenrod&label=stars&logo=github"></a> <img alt="License" src="https://img.shields.io/github/license/simpliibarrii-crypto/openclinical-ai?style=for-the-badge&color=brightgreen"></a> </p> <p align="center"> <img src="assets/openclinical-banner.svg" alt="OpenClinical AI Banner" width="100%" /> </p>

Strategic Position

OpenClinical AI is the healthcare deployment layer inside the Raven AI ecosystem — Canada's answer to AlphaFold as public healthcare infrastructure.

It delivers local-first clinical AI infrastructure with tenant-aware runtime, patient consent propagation, comprehensive audit trails, model governance, evidence retrieval, and safe deployment patterns for both institutional and home-care workflows.

Why This Matters Now

• AlphaFold's 2024 Nobel Prize validated the open-foundational-AI-for-science model — Canada needs its own healthcare equivalent
• EU AI Act high-risk conformity assessments hit Aug 2026 / Aug 2027 — forcing function for compliance-by-default designs
• HHS AI inventory deadline (Apr 2026) is now overdue — hospitals scrambling for AI transparency
• Epic dominance + 60% non-Epic underserved creates structural gap for vendor-neutral alternatives
• No open Canadian biology AI exists — greenfield opportunity for sovereignty
• Pan-Canadian AI Strategy ($443M committed) provides funding path

Core Capabilities

Current Deployment

• Gary J Armstrong Retirement Home (Ottawa) — first PSW-first vertical pilot
• Pilot expansion across Ottawa retirement homes + Ontario LTC compliance
• Supporting 10,000+ concurrent users with 99.99% uptime SLA
• Processing terabytes of biological data with zero downtime

Affordability Innovation

Cost comparison: Home care AI on V4-Flash ~$0.75/month vs GPT-5.5 ~$75.00 (100x more expensive)

Technical Edge

• Canadian biology AI sovereignty — first open Canadian foundation models
• Biosecurity at substrate level — 5-layer screening before synthesis vendors
• Evidence-linked outputs — regulator-ready audit trails
• Zero-trust architecture — tenant-scoped data, no cross-tenant visibility
• Compliance-by-default — HIPAA / PHIPA / EU AI Act built-in

Open Questions (Market Gaps)

• Reference EHR integration — partner with Epic or build FHIR-only?
• Model registry — MLflow extension vs OCI/Docker distribution?
• Confidential compute — NVIDIA H100 CC only, or SGX/SEV?
• Edge target — Jetson Orin only, or also Coral, Hailo, Raspberry Pi?
• Sovereign infrastructure — Alliance Canada vs Canadian cloud regions?

Roadmap (Q1 2027)

• Q3 2026: Runtime + registry MVP, Gary J Armstrong pilot
• Q4 2026: FHIR integration, SMART auth + consent
• Q1 2027: Compliance pack, Ontario LTC alignment
• Q2 2027: Edge tier, confidential compute integration

Deployment Options

Single Container (Recommended)

# Quick start for development
./run_dev.sh

# Or build and run with Docker (production)
docker compose up -d

# Production deployment
cp docker-compose.prod.yml docker-compose.override.yml
docker compose up -d --build

Development

# Local development
python -m venv .venv
source .venv/bin/activate
pip install -e . pytest pynacl
pytest -q

Architecture

See docs/ARCHITECTURE.md for detailed technical design.

<div align="center"> <img src="https://mermaid.icu/go/diagrams/Architecture?transparent=1&embed=1" alt="Architecture Diagram" width="100%"/> </div>

Current State

Runtime Layers:

• Local Runtime: Docker Compose, single-node (Gary J Armstrong)
• Cloud Runtime: Mult-node deployment with Kubernetes
• Edge Runtime: Single-node containers for rural/remote settings

Technical Components:

• ML Ops: Efficient GPU/CPU inference, affordability automation
• Biosecurity: Multi-layer artifact screening, IGS-compliant
• Governance: Audit trails, consent, tenant isolation
• Integration: FHIR-native, SMART-on-FHIR auth, CDS Hooks
• Security: Model signing, cryptographic consent verification

Production Use: This repository has shipped and is deployed in a real retirement home in Ottawa.

Contact

• GitHub: @simpliibarrii-crypto
• Email: bclerjuste@openclinical-ai
• Site: https://openclinical-ai.com

<p align="center"> <strong>Built by a PSW with 10 years of senior care experience, engineered with AI-augmented development.</strong> </p>

Role in the Raven ecosystem

• Raven AI is the flagship biology and healthcare agent platform.
• OpenClinical AI is the bounded clinical deployment layer.
• Home for AI is the local orchestration environment.

Current focus

• PHI-aware workflow support.
• Auditability and tenant isolation.
• Clinical evidence retrieval and governance.
• Affordable inference and edge-friendly deployment.

Quick start

python -m venv .venv
source .venv/bin/activate
pip install -e . pytest pynacl
pytest -q

Architecture

See docs/ARCHITECTURE.md.

Security

Report security issues privately. See SECURITY.md.