# Vitanere

Open-source, open-weight health AI infrastructure for patients, providers, and AI agents.
Community-governed. Evidence-based. Privacy-preserving.

Source: https://github.com/narges-rzv/vitanere_homepage
Status: Open concept, active development.

---

## What Vitanere does

- FHIR data stream access (Epic/MyChart via SMART on FHIR, wearables, document upload)
- Health insights: active conditions, medications, labs, vitals, risk flags
- To-do generation: current care tasks and preventative health recommendations
- Clinical trial matching against ClinicalTrials.gov using patient FHIR data
- FDA real-world evidence submission (patient-reported outcomes, post-market surveillance)
- AI model pipeline: curated, vetted models with defined inclusion criteria and decision triggers
- Evidence-based Q&A: peer-reviewed literature search and summarization (top-tier journals only)
- Resource discovery: support groups, medication assistance, care logistics

---

## Who can use this

Patients
  Connect your own FHIR records, get personalized insights, participate in research.
  Auth: SMART on FHIR (patient/*.read scope) or patient-granted token.

Providers
  Access patient panels via existing EHR credentials or patient-granted access.
  Auth: SMART on FHIR (user/*.read scope).

AI Agents
  Structured API access. All actions are machine-callable via OpenAPI and MCP.
  Auth: API key or SMART on FHIR depending on endpoint.

---

## Agent Skills (verified and validated)

Vitanere provides handcrafted, verified skills for agents — not generated, not probabilistic.
Each skill has defined inputs, outputs, auth requirements, and has been tested against real systems.

Full registry: /.well-known/skills.json

### fhir_data_acquisition  [status: verified, v1.0.0]
Acquires patient health records from FHIR R4-compliant EHRs via SMART on FHIR OAuth 2.0.
Returns structured FHIR Bundles: Condition, MedicationRequest, Observation, AllergyIntolerance, Procedure, DiagnosticReport.
Tested against Epic (NYU), open FHIR R4 servers. Conforms to US Core IG.
  Auth:     SMART on FHIR (patient/*.read + openid + offline_access)
  Input:    patient_id, resource_types[], date_range
  Output:   FHIR R4 Bundle (application/fhir+json)
  Endpoint: GET /api/patient/records
  MCP tool: get_patient_records

### imaging_data_acquisition  [status: verified, v1.0.0]
Retrieves medical imaging data and structured metadata from connected PACS via WADO-RS.
Supports CT, MRI, X-Ray, Ultrasound, PET, Mammography. Returns DICOM metadata + image refs.
Tested with DICOM-compliant PACS systems.
  Auth:     SMART on FHIR (patient/*.read)
  Input:    patient_id, modality (optional), date_range, include_preprocessed
  Output:   DICOM metadata + WADO-RS URLs + preprocessed image refs (application/json)
  Endpoint: GET /api/imaging
  MCP tool: get_imaging_data

In validation (not yet released): clinical_trial_matching, evidence_search, medication_interaction_check, wearable_data_acquisition

---

## API access for agents

OpenAPI spec:     /.well-known/openapi.json
Agent manifest:   /.well-known/ai-plugin.json
MCP server:       /mcp  (planned)
Auth:             SMART on FHIR — OAuth 2.0 with PKCE

All /api/* endpoints return structured JSON. No HTML responses.
Mutating endpoints require Idempotency-Key header.
Async operations return { job_id } — poll GET /api/jobs/{id} for status.

---

## Key API actions

GET  /api/patient/summary           Patient demographics, conditions, meds, recent labs
GET  /api/patient/records           Full FHIR record (problems, allergies, labs, imaging, vitals)
GET  /api/patient/medications       Medications with interaction flags
GET  /api/patient/todos             Current + preventative care tasks with priority scores
GET  /api/trials/match              Clinical trials patient qualifies for
POST /api/evidence/search           Evidence-based Q&A against published literature
GET  /api/models                    Curated AI models applicable to patient conditions
POST /api/models/{id}/run           Run a vetted AI model against patient data
POST /api/sms/enroll                SMS onboarding and care reminder setup
GET  /api/appointments/slots        Available slots by location and insurance
POST /api/appointments/book         Book appointment (Idempotency-Key required)
POST /api/calendar/event            Push event to Google / iCal / Outlook
GET  /api/resources                 Support groups, medication assistance, care logistics
POST /api/auth/fhir/init            Initiate SMART on FHIR OAuth flow
GET  /api/auth/fhir/callback        OAuth callback handler

---

## The Constitution (six founding principles)

01  Data sovereignty       — Patient data belongs to the patient. Never sold or brokered.
02  Open by default        — All models, algorithms, pipelines: open source, open weight.
03  Evidence first         — Recommendations trace to peer-reviewed literature. Sources cited.
04  Community governed     — Direction set by patients, clinicians, researchers. Not investors.
05  Agent-native           — Equal structured access for humans and AI agents.
06  Privacy-preserving     — Local-first where possible. Federated where necessary.