Synheart Wear Overview

{
  "timestamp": "2025-10-20T18:30:00Z",
  "device_id": "applewatch_1234",
  "source": "apple_healthkit",
  "metrics": {
    "hr": 72,
    "hrv_rmssd": 45,
    "hrv_sdnn": 62,
    "steps": 1045,
    "calories": 120.4,
    "distance": 2.5
  },
  "meta": {
    "battery": 0.82,
    "firmware_version": "10.1",
    "synced": true
  },
  "rr_ms": [800, 850, 820]
}

┌──────────────────────────────────────────────────────┐
│              Synheart Wear Ecosystem                 │
│         (Documentation & Specifications)             │
└──────────────────────────────────────────────────────┘
                         │
        ┌────────────────┼────────────────┐
        │                │                │
┌───────▼────────┐ ┌─────▼─────┐ ┌───────▼────────┐
│ synheart-wear- │ │synheart-  │ │ synheart-wear- │
│     dart       │ │wear-kotlin│ │     swift      │
│  (Flutter)     │ │ (Android) │ │     (iOS)      │
└────────────────┘ └───────────┘ └────────────────┘
        │                │                │
        └────────────────┼────────────────┘
                         │
                ┌────────▼─────────┐
                │ synheart-wear-cli │
                │   (Python CLI)    │
                │  + Local Server   │
                │  + ngrok Tunnel   │
                └───────────────────┘

┌─────────────────────────┐
│   synheart_wear SDK     │
├─────────────────────────┤
│ Device Adapters Layer   │
│ (Apple, Fitbit, etc.)   │
├─────────────────────────┤
│ Normalization Engine    │
│ (standard output schema)│
├─────────────────────────┤
│   Flux Pipeline (HSI)  │
│   (WHOOP, Garmin)       │
├─────────────────────────┤
│   Local Cache & Storage │
│   (encrypted, offline)  │
└─────────────────────────┘

// Enable Flux in config
final synheart = SynheartWear(
  config: SynheartWearConfig(enableFlux: true),
);

// Process vendor data through Flux
final hsiData = await synheart.readFluxSnapshot(
  vendor: Vendor.whoop,
  rawJson: jsonEncode(rawData),
);

dependencies:
  synheart_wear: ^0.3.0

implementation("com.github.synheart-ai:synheart-wear-android:0.3.0")

.package(url: "https://github.com/synheart-ai/synheart-wear-ios.git", from: "0.2.0")

pip install synheart-wear-cli

final synheart = SynheartWear(
  config: SynheartWearConfig.withAdapters({
    DeviceAdapter.appleHealthKit,
  }),
);

synheart.streamHR(interval: Duration(seconds: 5))
  .listen((metrics) {
    final hr = metrics.getMetric(MetricType.hr);
    if (hr != null && hr > 120) {
      showAlert('High heart rate detected!');
    }
  });

// Stream biosignals from wearable
synheart.streamHRV(windowSize: Duration(seconds: 60))
  .listen((metrics) {
    final hr = metrics.getMetric(MetricType.hr);
    final rrIntervals = metrics.rrIntervals;

    // Feed into emotion engine
    emotionEngine.push(
      hr: hr,
      rrIntervalsMs: rrIntervals,
      timestamp: DateTime.now(),
    );
  });

// Configure for research-grade data collection with Flux
final synheart = SynheartWear(
  config: SynheartWearConfig(
    enableFlux: true,
    enableLocalCaching: true,
    enableEncryption: true,
  ),
);

// Fetch and process vendor data through Flux
final whoopProvider = WhoopProvider(
  appId: 'your-app-id',
  userId: 'user-123',
);
final rawData = await whoopProvider.fetchRawDataForFlux(
  start: studyStartDate,
  end: studyEndDate,
);

// Process to HSI 1.0 format
final hsiData = await synheart.readFluxSnapshot(
  vendor: Vendor.whoop,
  rawJson: jsonEncode(rawData),
);
// HSI data is ready for analysis