DEV Community

Gautam
Gautam

Posted on

AuraFlow AI: An Animated Breathing Experience Powered by Human Signals

Presage SmartSpectra SDK Challenge Submission

This is a submission for the Presage SmartSpectra SDK Challenge.

What I Built

I built AuraFlow AI, a desktop wellness experience that transforms real-time human biometric signals into an interactive visual breathing experience.

The idea is simple: instead of presenting biometric measurements as numbers on a screen, what if we could make those signals visible, immersive, and engaging?

AuraFlow AI uses the Presage SmartSpectra SDK to access camera-based human signals and presents them through an animated, luminous 3D-style orb.

The experience includes:

  • Aura Orb: An animated, fluid energy sphere with cyan, electric blue, violet, and magenta lighting.
  • Breathing Ocean: A generative ocean environment that creates a calming visual experience.
  • Live Biometrics Dashboard: Displays pulse rate, breathing rate, HRV (RMSSD), and signal quality when validated measurements are available.
  • Responsive Animation: The Aura Orb adapts its breathing animation to validated respiratory measurements.
  • Camera Framing: Helps users position themselves correctly for optical sensing.
  • Session Controls: Start, pause, resume, and stop sensing.
  • Simulation Mode: Allows testing the visual experience without a camera or live SDK measurements. Simulated values are clearly identified.

AuraFlow AI is built with Electron, React, TypeScript, and the Presage SmartSpectra Node SDK.

Demo

Demo video: https://drive.google.com/file/d/1KXy6ddIkz4fkbHQdoxwSPUIeXKOS-wZl/view?usp=sharing

The demo will show:

  1. Launching AuraFlow AI.
  2. Giving camera permission and starting a sensing session.
  3. Positioning the face and upper body for optical capture.
  4. Acquiring live SmartSpectra signals.
  5. Displaying validated biometric measurements.
  6. Showing how the Aura Orb responds to breathing measurements.
  7. Demonstrating pause, resume, and stop controls.

The most important part of the demo is showing the actual live Presage signals and their effect on the experience, rather than relying on simulated data.

Code

GitHub Repository: https://github.com/gunmasterg9/AuraFlow

The project includes:

  • Electron desktop application.
  • React and TypeScript frontend.
  • SmartSpectra SDK integration.
  • Electron main-process and preload integration.
  • Camera permission handling.
  • Animated Aura Orb and Breathing Ocean components.
  • Biometric dashboard.
  • Secure local API key management.
  • Windows build and packaging configuration.

Run Locally

Requirements:

  • Windows 10/11
  • Node.js and npm
  • A compatible webcam
  • A valid Presage SmartSpectra API key
git clone YOUR_GITHUB_REPOSITORY_URL
cd AuraFlow-AI

npm install
npm run typecheck
npm run build
npm run dev
Enter fullscreen mode Exit fullscreen mode

Enter the SmartSpectra API key through the application's Settings interface. Do not commit credentials to the repository.

See the README for the complete setup instructions.

How It Responds to Human Signals

The core of AuraFlow AI is its integration with the Presage SmartSpectra SDK.

The application uses the SDK's renderer integration and Electron IPC bridge to connect camera-based optical sensing with the desktop experience.

Signals Used

1. Breathing Rate

Breathing rate is the primary signal driving the Aura Orb experience.

When a validated respiratory measurement is available, the orb's animation can synchronize with the measured breathing rhythm.

  • Inhale: The orb gradually expands and its cyan highlights become brighter.
  • Hold: The orb maintains its expanded state with a subtle internal glow.
  • Exhale: The orb contracts while its violet and blue light refractions shift.
  • Rest: The orb returns to its resting state.

The animation is designed to follow the measured respiratory rhythm rather than force the user into an arbitrary breathing pattern.

2. Pulse Rate

Pulse rate is presented in the biometric dashboard when a validated measurement is available. It provides additional awareness of the user's current physiological signals.

3. Heart Rate Variability (HRV RMSSD)

HRV RMSSD is displayed as another biometric indicator when valid data is available.

4. Signal Quality

Signal quality and validation feedback help users understand whether the camera is positioned appropriately and whether the application is receiving usable optical signals.

SmartSpectra SDK Integration

The implementation uses the following integration structure:

  • @smartspectra/node-sdk/renderer for renderer-side SDK functionality.
  • @smartspectra/node-sdk/messages for message decoding.
  • @smartspectra/node-sdk/main for Electron main-process IPC binding.
  • @smartspectra/node-sdk/preload for the SDK preload bridge.

The Electron main process establishes the SDK IPC connection, while the preload layer provides the bridge required by the renderer.

The React application coordinates the sensing lifecycle, measurement updates, and visual experience.

An important design decision was to separate actual measurements from the visual layer. The UI does not invent biometric readings. When validated data is unavailable, it displays an empty state rather than presenting fabricated measurements as real.

Prize Categories

I am entering both prize categories.

Most Creative or Delightful Use

The inspiration behind AuraFlow AI was to make invisible human signals visible.

Biometric information is usually presented through charts, numbers, and graphs. I wanted to explore a different approach: transforming breathing measurements into a living visual experience.

The Aura Orb is designed as a luminous, fluid energy sphere. Its movement, expansion, and changing light create a connection between the user's physiological rhythm and the visual environment.

The combination of optical sensing, animated graphics, and an immersive wellness interface makes the experience more engaging than a conventional biometric dashboard.

Best Thoughtful Real-World Use

Modern digital experiences often demand continuous attention. AuraFlow AI explores a calmer alternative.

It is designed for people who want a simple way to observe their breathing rhythm and engage with a visual wellness experience.

The application emphasizes:

  • A simple, accessible desktop interface.
  • Clear camera consent and sensing controls.
  • Visual feedback instead of overwhelming numerical information.
  • A natural breathing experience without forcing a prescribed rhythm.
  • Privacy-conscious local processing.
  • Clear separation between real measurements and simulated demonstrations.

AuraFlow AI is a wellness and self-awareness experience, not a medical device. It does not diagnose conditions, prescribe treatment, or make medical decisions.

Consent and Data Handling

Privacy was an important consideration throughout development.

Camera consent

  • Camera sensing begins only after the user explicitly selects the Begin Sensing action and grants camera permission.
  • The application provides a camera framing interface and clear sensing status.
  • Users can stop a session at any time.

Video processing

  • Camera frames are processed for optical sensing.
  • The application is designed not to record or persist camera video.
  • Camera tracks are stopped when the sensing session ends.

API key security

  • The SmartSpectra API key is entered locally through the application's Settings interface.
  • On Windows, the application uses Electron safeStorage to protect stored credentials with the operating system's data protection facilities.
  • API keys are not included in source control.

SDK telemetry

  • SDK telemetry is explicitly disabled using enableTelemetry: false.

Biometric information

  • Measurements are used by the application for the live dashboard and visual response.
  • The application does not present invalid or unavailable measurements as real values.

AuraFlow AI is intended for personal wellness awareness and is not intended for diagnosis, treatment, or medical decision-making.

Agent Session

The development process included SDK integration, Electron IPC configuration, camera permission handling, frontend development, TypeScript validation, and Windows desktop packaging.

Final Thoughts

Building AuraFlow AI gave me an opportunity to explore a different way of interacting with human signals.

Instead of simply measuring the body, I wanted to create an experience that lets people see and connect with their natural breathing rhythm.

Make your breathing visible. Find your rhythm. Find your calm.

Thanks to Presage and the Dev.to community for this challenge!

Top comments (0)