Skip to main content

Getting started

New here? This page orients you: the one idea that shapes the whole system, and the fastest path through the docs for whatever you came to do. For what each piece is, see the Overview; for how it all works, see Architecture.

ESP32-S3 recorder nRF52840 pendant iOS companion app React + Vite web app

The one idea

Audio flows from a device in someone's hand to a finished report on the web: captured on hardware, synced to the cloud, transcribed and analysed by an AI model, then presented to the clinician. Almost every design decision follows from a single guarantee.

The guiding principle

A recording is never treated as safely delivered until the cloud has verifiably stored it. A device keeps its own copy of audio until storage is confirmed byte-for-byte, and the long-running AI step lives in a process that can take as long as it needs — never on a request that might time out mid-transcription.

Find your path

Reading paths by task

If you're…Start withThen read
New to the projectOverviewArchitectureThe component guide for your area
Building recorder / pendant firmwareRecorder · PendantHardware testing · Firmware release
Working on the backend or pipelineBackend pipelineDevice API · Data model
Building the mobile or web appMobile app · Web appBLE protocol
Operating or testing devicesHardware testingThe sate CLI · Troubleshooting

The parts at a glance

Recorder
ESP32-S3
Pendant
nRF52840
Mobile app
iOS
Web app
React + Vite
Audio format
16 kHz mono
Sync
Wi-Fi + BLE
Backend
Edge + container
AI
Async transcription

Each of these is versioned and released independently. The component guides cover them one by one; the Version log tracks what changed in each release.