Quick Start

Quick Start Guide

Access the Live System

Open your browser → iris.brainsait.org

Field	Value
Username	_SYSTEM
Password	sys
Namespace	BRAINSAIT

Local Development

# Clone the repository
git clone https://github.com/Fadil369/brainsait-linc-fhir.git
cd brainsait-linc-fhir

# Start the Docker ecosystem
docker compose -f infra/deployment/docker-compose.yml up -d

# Run startup script (Python services)
bash scripts/startup.sh

# Quick health check
curl http://localhost:58080/health
curl http://localhost:58080/routes

Verify All Services

# Docker containers (expect 13 all healthy)
docker ps --format "table {{.Names}}\t{{.Status}}"

# Python microservices on host ports
for p in 58773 58080 58081 58082 58083 3000; do
  n=$([ $p = 58773 ] && echo "Supervisor" || [ $p = 58080 ] && echo "Gateway" || [ $p = 58081 ] && echo "Dashboard" || [ $p = 58082 ] && echo "Webhook" || [ $p = 58083 ] && echo "Metrics" || echo "Grafana")
  ss -tlnp | grep -q ":$p " && echo "✅ $n :$p" || echo "❌ $n :$p"
done

API Discovery

# List all available routes
curl http://localhost:58080/routes | jq .

# FHIR metadata (synthetic CapabilityStatement)
curl http://localhost:58080/fhir/metadata | jq .

# System health
curl http://localhost:58080/health | jq .

# Pulse AI Agents — 14 deployed
curl http://localhost:58080/linc/ | jq .
curl "http://localhost:58080/linc/summary?patient=P-5842&role=doctor" | jq .
curl "http://localhost:58080/linc/readmission-risk?patient=P-5842" | jq .

# HuggingFace Models
curl http://localhost:58080/hf/models | jq .

# Chat AI
curl "http://localhost:58080/hf/chat?q=what+is+normal+blood+sugar" | jq .

Pulse Agents Quick Test

# Test all 14 agents
for agent in summary prior-auth gaps-in-care medication-safety care-plan clinical-trials readmission-risk triage imaging-followup lab-explainer nl-query sdoh-referral chat hf-models; do
  STATUS=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:58080/linc/$agent?patient=P-5842")
  echo "$agent → HTTP $STATUS"
done

NPHIES Pipeline

# Diagnose the submission pipeline
python3 pipeline/submission_pipeline.py --diagnose

# Dry-run a claim submission
python3 pipeline/submission_pipeline.py --dry-run

# Full submission
python3 pipeline/submission_pipeline.py --phase 1

Local Access Points

Service	Local URL
API Gateway	http://localhost:58080/
Live Dashboard	http://localhost:58081/
IRIS Portal	http://localhost:52773/csp/sys/UtilHome.csp
Grafana	http://localhost:3000/
Ecosystem Supervisor	http://localhost:58773/
Webhook Receiver	http://localhost:58082/
Metrics Exporter	http://localhost:58083/metrics