nuanic-ring 0.1.1

Nuanic and Moodmetric BLE ring data extraction SDK

Nuanic & Moodmetric Ring BLE SDK

A Python library for connecting, monitoring, and capturing raw electrodermal activity (EDA) and IMU waveforms from Nuanic and legacy Moodmetric BLE rings. Includes a real-time Moodmetric-like Arousal Scoring pipeline and a live Matplotlib dashboard.

---

🚀 Quick Start

1. Installation

python -m venv .venv
# Windows
.\.venv\Scripts\Activate.ps1
# Linux/Mac
source .venv/bin/activate

pip install -e ".[dev]"

2. Connect & Monitor

# Start standard monitoring (lazy-logs session data to CSV)
nuanic-ring-monitor --calibration-seconds 60

# Launch live dashboard visualization
nuanic-ring-monitor --waveform

# Run post-session analysis on a log
nuanic-ring-analyzer data/ring_logs/my_session.csv

---

🔗 Multi-Ring Setup

# Connect to all discovered Nuanic rings
nuanic-ring-monitor --monitor-all --target-hz 16

# Explicitly target specific MAC addresses
nuanic-ring-monitor --ring-addrs MAC1,MAC2 --target-hz 16 --reset-bt

---

🛠️ Usage in Code

import asyncio
from nuanic_ring.monitor import NuanicMonitor

async def run_sensor():
    # Initialize monitor with a 60-second baseline calibration window
    monitor = NuanicMonitor(calibration_seconds=60)
    
    # Run the monitor for 120 seconds
    await monitor.run(duration_seconds=120)

asyncio.run(run_sensor())

For advanced multi-ring orchestration, see Python API Usage in the Master Guide.

---

📖 Documentation Directory

Refer to the detailed documents below for deep dives into SDK features, file formats, and hardware interpretations:

• 📂 CSV Log Format Guide: Detailed breakdown of the output CSV columns, record types (D306_EDA, IMU_BATCH_468F, etc.), scaling formulations, and offline Pandas parsing.
• 📂 Ring Master Guide: Setup workflows, advanced multi-ring controls, troubleshooting, and the Full CLI Argument Reference & GATT UUID Mapping tables.
• 📂 Ring Reverse-Engineering Report: Low-level BLE forensics, profile validations, and raw characteristic payload structures.