Skip to main content

AI-powered telehealth compliance gateway with deterministic safety

Project description

MOA Telehealth Governor

Multi-agent Orchestration Architecture for Healthcare Compliance

Owner: Michael Ordon Version: 2.0.0 (Rhythm Enhancement) Status: PROPRIETARY — DO NOT DISTRIBUTE


Quick Start

# Backend (FastAPI)
cd moa_telehealth_governor
pip install -r requirements.txt
python run_demo.py

# Frontend (React + Vite)
cd client
npm install
npm run dev  # http://localhost:5173

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    MOA TELEHEALTH GOVERNOR                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────┐    ┌──────────────┐    ┌───────────────┐         │
│  │  React   │───►│   FastAPI    │───►│ TelehealthGov │         │
│  │   UI     │    │   /govern    │    │   Governor    │         │
│  └──────────┘    └──────────────┘    └───────┬───────┘         │
│                                              │                  │
│       ┌──────────────────────────────────────┼──────────┐      │
│       ▼                  ▼                   ▼          ▼      │
│  ┌──────────┐    ┌──────────────┐    ┌──────────┐  ┌────────┐ │
│  │   ESM    │    │   Rhythm     │    │   Moa    │  │ Stripe │ │
│  │Compressor│    │   Tracker    │    │  Router  │  │Billing │ │
│  └──────────┘    └──────────────┘    └──────────┘  └────────┘ │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Core Components

/src/governor/telehealth_governor.py

Main orchestrator. Processes user input, routes by risk zone (GREEN/YELLOW/RED).

/src/physics/esm_compressor.py

FFT-based spectral analysis. Computes entropy for bot/human detection.

/src/physics/rhythm_dynamics.py ⭐ NEW

Adaptive α (forgetting rate) per spectral mode. Trade secret.

/src/routing/moa_router.py

Zone-based model routing. GREEN → Ollama (local), YELLOW → Cloud, RED → Frontier + human.

/src/billing/stripe_integration.py

Payment processing. Ready for metered billing.

/client/

React + shadcn/ui frontend. Vite dev server with proxy to FastAPI.


Key IP (Trade Secrets)

Component Value Protection
61-node graph topology $50-100K Never open-source
Rhythm dynamics (adaptive α) $100K+ Proprietary
Prime Gödel codes (343 states) $75K Patent pending
Event-to-injection mappings $75-150K/vertical Licensed separately

Tier Structure

Tier Price Includes
OPEN Free Theory, basic examples
PRO $49-299/mo Healthcare events, rhythm
ENTERPRISE $2,499+/mo Custom calibration, SLA

Tests

python run_demo.py           # 3 scenarios
python run_full_demo.py      # 67% token savings demo
python tests/verify_esm_physics.py

Audit Checklist

  • Verify spectral entropy calculation (esm_compressor.py)
  • Check rhythm dynamics α bounds (0.01-0.15)
  • Validate Prime Gödel bijection (343 unique codes)
  • Confirm zone routing logic (GREEN/YELLOW/RED)
  • Review crisis keyword detection (mcp_interceptor.py)
  • Test Ollama fallback in moa_router.py

Files to Review

src/
├── governor/telehealth_governor.py  # Main orchestrator
├── physics/
│   ├── esm_compressor.py            # FFT + entropy
│   ├── rhythm_dynamics.py           # Adaptive α
│   └── prime_codecs.py              # Gödel encoding
├── routing/moa_router.py            # Model tier routing
├── governance/mcp_interceptor.py    # Regulatory checks
└── billing/stripe_integration.py    # Payments

config/
├── router_config.yaml               # Model providers
└── thresholds.yaml                  # Risk thresholds

client/                              # React UI
tests/                               # Verification scripts

Known Issues

  1. verify_esm_physics.py — CHAOS/HUMAN thresholds need recalibration
  2. TypeScript lint errors in client (tsconfig paths)
  3. Ollama may timeout on first model load (30s)

Contact

Michael Ordon — grzywajk@gmail.com

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

teletrust-1.0.0.tar.gz (12.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

teletrust-1.0.0-py3-none-any.whl (138.4 kB view details)

Uploaded Python 3

File details

Details for the file teletrust-1.0.0.tar.gz.

File metadata

  • Download URL: teletrust-1.0.0.tar.gz
  • Upload date:
  • Size: 12.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for teletrust-1.0.0.tar.gz
Algorithm Hash digest
SHA256 869558e23ab4ecad80dff1a3372e68e7eace2bab9d01c08af9d04a6e4ba52558
MD5 4e9f21b8bb93fced5b9ae92273fd2d30
BLAKE2b-256 487296dcee3d5c6877a9b5190649666186119b3ef9bb1037969c0e52391133bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for teletrust-1.0.0.tar.gz:

Publisher: pypi-release.yml on grzywajk-beep/moa_telehealth_governor

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file teletrust-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: teletrust-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 138.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for teletrust-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d81f7554469a775c77bd3b144de7b8c8b41839396796d7345dfba1405cae6606
MD5 6e1b7495d25a09285085194123183b8b
BLAKE2b-256 ffb10ef960ff13e387625ea85926ff260e7d4b1b13f412c557412938e8f4283d

See more details on using hashes here.

Provenance

The following attestation bundles were made for teletrust-1.0.0-py3-none-any.whl:

Publisher: pypi-release.yml on grzywajk-beep/moa_telehealth_governor

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page