Mediroute: An open-source AI platform exposing global drug price disparities

Compare global drug prices · Check import legality · AI Medicine Agent

Making life-saving medication accessible and affordable for everyone, everywhere.

MediRoute is an open-source HealthTech + RegTech + AI Agent platform that helps patients:

• 💊 Compare real drug prices across 5 core markets (US, Canada, India, Singapore, UK)
• ⚖️ Check import legality — green/yellow/red compliance light for every country pair, with legal source citations
• 🤖 Get AI guidance — AI Medicine Agent recommends drugs and sourcing options based on your country, condition, and budget
• 🔍 Monitor shortages — Drug Shortage Radar with therapeutic alternative suggestions
• ✅ Verify suppliers — GMP/GDP/FDA/EMA certification tracking with Trust Score

This is not a pharmacy or a marketplace. MediRoute is a medicine intelligence platform — think of it as Bloomberg for global drug pricing, with a regulatory compliance layer built in.

A cancer patient in the United States pays $9,800/month for Imatinib. The exact same drug, same molecule, manufactured to WHO-GMP standards, costs $208/month from India.

Most patients don't know this. Those who do, don't know if it's legal to import it. Those who find out it might be legal, don't know which suppliers are trustworthy.

MediRoute solves all three problems.

cp .env.example .env        # fill in ANTHROPIC_API_KEY at minimum
docker compose up --build

This spins up Postgres, Redis, the backend (hot-reload), and the frontend (Vite dev server) together. See docs/ENVIRONMENT.md for what every variable does.

For a production-like stack (built assets, nginx reverse proxy, no hot-reload — useful for testing self-hosted deployments outside Render):

cp .env.example .env        # set real SECRET_KEY / POSTGRES_PASSWORD / etc.
docker compose -f docker-compose.prod.yml up --build -d
cd frontend
npm install
npm run dev
cd backend
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env        # Fill in your ANTHROPIC_API_KEY
uvicorn app_v3.entrypoint.app:app --reload

cd frontend
cp .env.example .env
npm install && npm run dev
MediRoute uses Domain-Driven Design (DDD) with a Modular Monolith pattern,
ready to split into microservices when scale demands it.

├── modules/
│   ├── identity/           # Auth, JWT, RBAC (5 roles)
│   ├── drug_intelligence/  # 100-drug catalog, interactions, shortages
│   ├── compliance/         # 20 bilateral import rules (5×4 country pairs)
│   ├── market_intelligence/# Price comparison, supplier trust scores
│   ├── order_workflow/     # Order FSM + Escrow logic
│   └── ai_agent/           # Claude-powered consultation + OCR
└── shared/
    ├── security/           # JWT, RBAC, immutable Audit Log
    └── infrastructure/     # Event bus, cache (Redis-ready), Unit of Work

Full architecture blueprint: docs/10_production_architecture_blueprint.md

mediroute/
├── backend/
│   ├── app_v3/              # ← the live backend (DDD modular monolith)
│   ├── alembic/              # DB migrations
│   ├── Dockerfile
│   └── .env.example
├── frontend/
│   ├── Dockerfile             # production build served via nginx
│   ├── nginx.conf             # nginx config baked into the frontend image
│   └── .env.example
├── docker/
│   └── nginx/nginx.conf       # reverse proxy for self-hosted docker-compose.prod.yml
├── docs/                      # architecture, API design, environment reference
├── docker-compose.yml          # local dev stack (hot reload)
├── docker-compose.prod.yml     # self-hosted production stack (nginx + built assets)
├── render.yaml                 # Render Blueprint (used for the hosted deployment)
└── .env.example

We especially need help with:

1. Drug data — accurate pricing, ATC codes, brand names for more drugs
2. Compliance research — import rules for more country pairs (legal citations required)
3. Translations — the UI needs more languages
4. Country expansion — adding markets beyond the current 5

See CONTRIBUTING.md for full guidelines.

Medical/regulatory contributions require cited sources. Unsourced compliance rules are rejected — incorrect import rules could harm patients.

Medical: This platform provides information only. It does not constitute medical advice. Always consult a licensed physician before making medication decisions.

Regulatory: Import regulations change. Always verify current rules with official authorities and a licensed customs broker before importing medication.

Pricing: Prices are indicative. Always confirm current pricing directly with suppliers before ordering.

Full environment variable reference: docs/ENVIRONMENT.md CI/CD pipeline (GitHub Actions → Render) and how to set it up: docs/CI_CD.md Security features (JWT refresh, rate limiting, secrets) — Sprint 3 summary: docs/SPRINT3_SECURITY.md Monitoring (logging, Prometheus/Grafana, Sentry, uptime alerts) — Sprint 4 summary: docs/MONITORING.md Testing (unit/integration/E2E, coverage, and two real bugs the tests caught) — Sprint 5 summary: docs/SPRINT5_TESTING.md Internationalization (12 locales, date/currency/unit formatting, hreflang) — Sprint 6 summary: docs/SPRINT6_I18N.md API reference (every endpoint, curl examples, error codes) — Sprint 7: docs/API.md · Interactive docs at /docs · SDKs: Python, JavaScript · docs/SPRINT7_API_DOCS.md Production review (a real data-loss bug found & fixed, security hardening, honest known-gaps list) — Sprint 8: docs/SPRINT8_PRODUCTION_REVIEW.md Internationalization (12 locales, currency/date formatting, hreflang) — Sprint 6 summary: docs/SPRINT6_I18N.md

MIT License — see LICENSE for details.

This project is open source and welcomes contributions. The mission is bigger than any single company: making life-saving medicine accessible to everyone, everywhere.

Built with ❤️ for patients who deserve better