💜 withLove

The First Self-Driving Platform for InterSystems IRIS Health

Vibe-code your healthcare infrastructure — IRIS-native, FHIR-compliant, delightfully fast.

---

🚀 Motivation

Building healthcare applications is hard. Creating FHIR APIs, integrating legacy systems (HL7v2), managing multi-tenant databases, and maintaining interoperability workflows requires months of development and deep expertise in InterSystems IRIS for Health.

withLove changes everything.

It's the first "loveable" (delightful + powerful) platform that lets hospitals, clinics, EHR vendors, and healthtech ISVs create:

• ✅ FHIR R4-compliant REST APIs in seconds
• ✅ Multi-tenant persistent classes (SQL tables) automatically
• ✅ Interoperability workflows (HL7, DTL, Business Operations) via natural language
• ✅ Admin UIs (CRUD interfaces) with modern frameworks (Tailwind/Alpine.js)
• ✅ RAG-powered knowledge base for protocol-driven development

All through a conversational AI interface — just describe what you need in plain language, and withLove builds it for you.

---

🛠️ How It Works

withLove utilizes a multi-agent architecture powered by cutting-edge technologies:

Core Technologies

1. InterSystems IRIS for Health
   High-performance healthcare data platform with native FHIR, and HL7v2 support.

2. Multi-Agent AI System

   • UI Agent: Generates responsive frontends (Tailwind CSS + Alpine.js)
   • Backend Agent: Creates persistent classes (multi-tenant SQL tables)
   • API Agent: Builds REST APIs with dynamic routing
   • Interop Agent: Generates DTL transformations and Business Operations
   • Knowledge Agent: RAG-powered document search (384-dim vectors)
   • Scanner Agent: Analyzes brownfield code and suggests modernization paths

3. LLM Integration
   Supports OpenAI ChatGPT, Google Gemini and Anthropic (Claude) via flexible API key configuration.

4. FHIR R4 Native
   Full compliance with HL7 FHIR R4 standard, including Bundle validation and SDA3 transformation.

Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                    User (Chat Interface)                    │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│              GenAi.AgentRun() (Orchestrator)                │
│  - Intent Detection (CREATE_API, CREATE_TABLE, SCAN, etc)   │
│  - Delegates to specialized factories                       │
└─────────────────────────┬───────────────────────────────────┘
                          │
         ┌────────────────┼────────────────┐
         ▼                ▼                ▼
┌─────────────────┐ ┌─────────────┐ ┌──────────────────┐
│   AppFactory    │ │ ApiFactory  │ │ ClassFactory     │
│ (UI Generator)  │ │(API Gen)    │ │(DB Tables)       │
└─────────────────┘ └─────────────┘ └──────────────────┘
         │                │                │
         └────────────────┼────────────────┘
                          ▼
┌─────────────────────────────────────────────────────────────┐
│        Multi-Tenant Deployment (dc.withLove.<tenant>)       │
│  - .apps (CSP Pages)                                        │
│  - .api (REST Services)                                     │
│  - .data (Persistent Classes)                               │
│  - .interop (DTL/BO/BS)                                     │
└─────────────────────────────────────────────────────────────┘

---

📋 Prerequisites

• Docker and Docker Compose installed on your machine
• API Key for LLM provider:
  • OpenAI API Key (sk-...) or
  • Anthropic API Key (sk-ant-...)
• Minimum 8GB RAM (16GB recommended for production)
• 10GB free disk space (FHIR Server installation requires additional storage)

---

🛠️ Installation

1. Clone the Repository

git clone https://github.com/musketeers-br/withLove
cd withLove

2. Build the Docker Container

docker-compose build --no-cache --progress=plain

4. Start the Application

docker-compose up -d

5. Wait for IRIS Startup

docker-compose logs -f iris

⚠️ Important Note:
This project automatically installs the FHIR Server via ZPM (zpm "install fhir-server"), which can take 15-25 minutes depending on your network speed and machine specs. Please be patient during the first startup.

You can also check the Management Portal (user: _system, password: SYS) to verify installation status.

---

💡 How to Use

Once withLove is running, access the Chat Interface:

🌐 Frontend: http://localhost:port/withlove/index.html

Example 1: Create a FHIR Patient API

💬 You: "Create a FHIR R4 API for managing patients with CPF validation"

🤖 withLove: 
✅ Detected: HS.SDA3.Patient (50,000 records)
✅ Generating CRUD endpoints:
   - GET /fhir/Patient
   - GET /fhir/Patient/:id
   - POST /fhir/Patient
   - PUT /fhir/Patient/:id

✅ Adding validations:
   - CPF format validator
   - Active status check

✅ Deploying to: /withlove/services/hospital-main/PatientAPI

Click "Approve" → API is live in seconds!

Test it:

curl -X GET http://localhost:52773/withlove/services/hospital-main/PatientAPI/list \
  -H "X-Tenant-ID: hospital-main" \
  -H "Authorization: Bearer your-api-key"

---

Example 2: Generate a Database Table

💬 You: "Create a table for Dengue cases with fields: PatientID, Symptoms, TestDate, Result"

🤖 withLove:
✅ Generating persistent class: dc.withLove.hospital-main.data.DengueCase
✅ Fields:
   - PatientID (String, indexed)
   - Symptoms (String, MAXLEN="")
   - TestDate (Date)
   - Result (String: Positive/Negative/Pending)
✅ Compiled successfully
✅ Table available: dc_withLove_hospital_main_data.DengueCase

---

Example 3: Create an HL7 Integration

💬 You: "Create a DTL to transform HL7 ADT^A04 messages into SDA3.Patient"

🤖 withLove:
✅ Generating DTL: dc.withLove.hospital-main.interop.ADTToPatient
✅ Source: EnsLib.HL7.Message (ADT_A04)
✅ Target: HS.SDA3.Patient
✅ Mappings:
   - PID:PatientName → Patient.Name
   - PID:PatientID → Patient.PatientNumbers
   - PID:DOB → Patient.BirthTime
✅ Compiled successfully

---

Example 4: Scan Brownfield System

💬 You: "Scan my system and suggest APIs to create"

🤖 withLove:
🔍 Scanning namespace: HSREGISTRY
✅ Found 127 classes (47 SDA3, 80 custom)

📊 Top Entities by Volume:
1. HS.SDA3.Patient (12.5M records) ⭐ Suggest: GET /fhir/Patient
2. HS.SDA3.Encounter (45M records) ⭐ Suggest: GET /fhir/Encounter
3. Custom.Lab.Result (22M) ⚠️ Not FHIR-compliant (suggest migration)

⚠️ Issues Detected:
- HS.SDA3.Encounter: Missing index on PatientID (slow queries >500ms)
- Custom.Patient.Insurance: No tenant isolation (security risk)

---

Example 5: Add Knowledge to RAG

Upload Protocol:

curl -X POST http://localhost:52773/api/knowledge/add \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: hospital-main" \
  -d '{
    "title": "Dengue Treatment Protocol 2026",
    "content": "Treatment guidelines for dengue patients..."
  }'

Query with Context:

💬 You: "How should I treat a dengue patient according to our protocol?"

🤖 withLove:
📚 Found relevant document: "Dengue Treatment Protocol 2026"

According to your protocol:
1. Immediate hydration (IV fluids)
2. Monitor platelet count every 6 hours
3. Administer paracetamol for fever (avoid NSAIDs)
...

---

🗂️ Project Structure

withLove/
├── src/
│   ├── dc/
│   │   └── withLove/
│   │       ├── engine/          # Core AI Factories
│   │       │   ├── GenAi.cls    # LLM Orchestrator
│   │       │   ├── AppFactory.cls
│   │       │   ├── ApiFactory.cls
│   │       │   ├── ClassFactory.cls
│   │       │   └── FHIRHandler.cls
│   │       │   └── InteropFactory.cls
│   │       ├── service/         # Business Logic
│   │       │   ├── Dispatch.cls # REST API Router
│   │       │   ├── KnowledgeService.cls
│   │       │   ├── ScannerService.cls
│   │       │   └── RestRouter.cls
│   │       └── storage/         # Data Models
│   │           ├── Project.cls
│   │           ├── AppVersion.cls
│   │           ├── Tenant.cls
│   │           ├── LLMSession.cls
│   │           └── KnowledgeBase.cls
├── csp/
│   ├── index.html              # Chat Interface
├── docker-compose.yml
├── Dockerfile
└── README.md

---

📹 Highlights: Building with Love 🤍

See the Full Stack Architect agent in action. Zero boilerplate, pure creation.

Category	Demo (Click to Watch)	Description
💾 Table (Backend)		Designing robust SQL Tables (%Persistent) with JSON adapters instantly.
🧠 RAG (Knowledge)		Teaching the AI about specific medication via Chat prompt.
🔌 API (Services)		Deploying a REST API with Auto-Healing & Error Handling.
🔥 FHIR (Integration)		*Generating synthetic FHIR R4 JSON *

Note: Click the images above to watch the YouTube Shorts.

---

🔌 API Reference

Core Endpoints

Endpoint	Method	Description
/withlove/api/agent/chat	POST	Conversational agent (main interface)
/withlove/api/deploy	POST	Deploy generated assets
/withlove/api/knowledge/add	POST	Add document to RAG
/withlove/api/knowledge/list	GET	List RAG documents

Dynamic Service Endpoints

Generated APIs follow the pattern:

/withlove/services/<tenant>/<service-name>/*

Example:

GET /withlove/services/hospital-main/PatientAPI/list
POST /withlove/services/hospital-main/PatientAPI/create
PUT /withlove/services/hospital-main/PatientAPI/update/:id

---

📊 Roadmap

✅ v0.9 MVP (Done)

• UI Agent (App generation)
• Backend Agent (Class generation)
• API Agent (REST API generation)
• Interop Agent (DTL/BO generation)
• RAG Knowledge Base
• Brownfield Scanner

---

🎖️ Credits

withLove is developed with 💜 by the Musketeers Team:

• José Roberto Pereira
• Henry Pereira
• Henrique Dias

---

📄 License

This project is licensed under the MIT License.

---

💬 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Community: InterSystems Developer Community