# saeed-hussain/cadence architecture

> Architecture diagram of the GitHub repository saeed-hussain/cadence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saeed-hussain/cadence
- Repository: https://github.com/saeed-hussain/cadence

## Overview

Cadence is a browser-based, on-device speech synthesis product. Users choose or audition a voice, enter text or provide a recording, and use the engine to produce audio; playback, voice browsing, studio, history, and engine-status pages provide the surrounding experience. The engine API dispatches inference to a worker, which runs the Kokoro backend. The README documents the voice library and current pitch-matched cloning behavior. Some app-to-engine and feature-page wiring is documented only at a high level, so the graph avoids guessing at individual page calls.

Main entry points: [`packages/cadence/src/index.js`](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/index.js) (Engine API), [`apps/web/app/page.jsx`](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/page.jsx) (Home), [`apps/web/components/Player.jsx`](https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Player.jsx) (Player UI), [`apps/web/app/text-to-speech/page.jsx`](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/text-to-speech/page.jsx) (Text to speech)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Home<br/>[page.jsx]"]
  node_text["Text to speech<br/>[page.jsx]"]
  node_studio["Studio<br/>[page.jsx]"]
  node_cloning["Voice cloning<br/>[page.jsx]"]
  node_changer["Voice changer<br/>[page.jsx]"]
  node_voicespage["Voice library<br/>[page.jsx]"]
  node_history["History<br/>[page.jsx]"]
  node_enginepage["Engine status<br/>[page.jsx]"]
  node_store["App state<br/>[store.jsx]"]
  node_picker["Voice picker<br/>[VoicePicker.jsx]"]
  node_controls["Audio controls<br/>[Controls.jsx]"]
  node_playerui["Player UI<br/>[Player.jsx]"]
end

subgraph group_engine["Engine control"]
  node_engineapi["Engine API<br/>[index.js]"]
  node_worker["Inference worker<br/>[worker.js]"]
end

subgraph group_synthesis["Synthesis backends"]
  node_kokoro["Kokoro backend<br/>[kokoro.js]"]
  node_piper["Piper backend<br/>[piper.js]"]
  node_dsp["Pitch analysis<br/>[dsp.js]"]
end

subgraph group_audio["Voices and playback"]
  node_voices["Voice catalog<br/>[voices.js]"]
  node_wav["WAV encoding<br/>[wav.js]"]
  node_audio["Audio playback<br/>[audio.js]"]
  node_waveform["Waveform display<br/>[Waveform.jsx]"]
  node_orb["Voice orb<br/>[Orb.jsx]"]
end

node_user(("User"))
node_onnx["ONNX Runtime Web"]

node_user -->|"uses"| node_home
node_home -->|"opens"| node_text
node_user -->|"uses"| node_studio
node_user -->|"provides recording"| node_cloning
node_user -->|"uses"| node_changer
node_user -->|"browses"| node_voicespage
node_user -->|"reviews"| node_history
node_user -->|"checks status"| node_enginepage
node_home -.->|"uses engine"| node_engineapi
node_text -.->|"uses engine"| node_engineapi
node_studio -.->|"uses engine"| node_engineapi
node_cloning -.->|"matches recording"| node_engineapi
node_voicespage -.->|"auditions voices"| node_engineapi
node_engineapi -->|"dispatches inference"| node_worker
node_worker -->|"loads backend"| node_kokoro
node_kokoro -->|"runs inference"| node_onnx
node_engineapi -->|"measures pitch"| node_dsp
node_engineapi -->|"matches pitch"| node_voices
node_picker -->|"reads voices"| node_store
node_playerui -->|"controls playback"| node_audio
node_orb -->|"reads playback level"| node_audio
node_playerui -->|"renders waveform"| node_waveform

click node_home "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/page.jsx"
click node_text "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/text-to-speech/page.jsx"
click node_studio "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/studio/page.jsx"
click node_cloning "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/voice-cloning/page.jsx"
click node_changer "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/voice-changer/page.jsx"
click node_voicespage "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/voices/page.jsx"
click node_history "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/history/page.jsx"
click node_enginepage "https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/engine/page.jsx"
click node_store "https://github.com/saeed-hussain/cadence/blob/main/apps/web/lib/store.jsx"
click node_picker "https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/VoicePicker.jsx"
click node_controls "https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Controls.jsx"
click node_playerui "https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Player.jsx"
click node_engineapi "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/index.js"
click node_worker "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/worker.js"
click node_kokoro "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/kokoro.js"
click node_piper "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/piper.js"
click node_dsp "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/dsp.js"
click node_voices "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/voices.js"
click node_wav "https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/wav.js"
click node_audio "https://github.com/saeed-hussain/cadence/blob/main/apps/web/lib/audio.js"
click node_waveform "https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Waveform.jsx"
click node_orb "https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Orb.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_text,node_studio,node_cloning,node_changer,node_voicespage,node_history,node_enginepage,node_store,node_picker,node_controls,node_playerui,node_user toneBlue
class node_engineapi,node_worker toneAmber
class node_kokoro,node_piper,node_dsp toneMint
class node_voices,node_wav,node_audio,node_waveform,node_orb toneRose
class node_onnx toneIndigo
```

## Components

### Web experience

- [Home](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/page.jsx): `apps/web/app/page.jsx`
- [Text to speech](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/text-to-speech/page.jsx): `apps/web/app/text-to-speech/page.jsx`
- [Studio](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/studio/page.jsx): `apps/web/app/studio/page.jsx`
- [Voice cloning](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/voice-cloning/page.jsx): `apps/web/app/voice-cloning/page.jsx`
- [Voice changer](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/voice-changer/page.jsx): `apps/web/app/voice-changer/page.jsx`
- [Voice library](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/voices/page.jsx): `apps/web/app/voices/page.jsx`
- [History](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/history/page.jsx): `apps/web/app/history/page.jsx`
- [Engine status](https://github.com/saeed-hussain/cadence/blob/main/apps/web/app/engine/page.jsx): `apps/web/app/engine/page.jsx`
- [App state](https://github.com/saeed-hussain/cadence/blob/main/apps/web/lib/store.jsx): `apps/web/lib/store.jsx`
- [Voice picker](https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/VoicePicker.jsx): `apps/web/components/VoicePicker.jsx`
- [Audio controls](https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Controls.jsx): `apps/web/components/Controls.jsx`
- [Player UI](https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Player.jsx): `apps/web/components/Player.jsx`

### Engine control

- [Engine API](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/index.js): `packages/cadence/src/index.js`
- [Inference worker](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/worker.js): `packages/cadence/src/worker.js`

### Synthesis backends

- [Kokoro backend](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/kokoro.js): `packages/cadence/src/kokoro.js`
- [Piper backend](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/piper.js): `packages/cadence/src/piper.js`
- [Pitch analysis](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/dsp.js): `packages/cadence/src/dsp.js`

### Voices and playback

- [Voice catalog](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/voices.js): `packages/cadence/src/voices.js`
- [WAV encoding](https://github.com/saeed-hussain/cadence/blob/main/packages/cadence/src/wav.js): `packages/cadence/src/wav.js`
- [Audio playback](https://github.com/saeed-hussain/cadence/blob/main/apps/web/lib/audio.js): `apps/web/lib/audio.js`
- [Waveform display](https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Waveform.jsx): `apps/web/components/Waveform.jsx`
- [Voice orb](https://github.com/saeed-hussain/cadence/blob/main/apps/web/components/Orb.jsx): `apps/web/components/Orb.jsx`

### Other components

- **User**
- **ONNX Runtime Web**

## Connections

- User → Home: uses
- Home → Text to speech: opens
- User → Studio: uses
- User → Voice cloning: provides recording (evidence: `README.md`)
- User → Voice changer: uses
- User → Voice library: browses (evidence: `README.md`)
- User → History: reviews
- User → Engine status: checks status
- Home → Engine API: uses engine (evidence: `README.md`)
- Text to speech → Engine API: uses engine (evidence: `README.md`)
- Studio → Engine API: uses engine (evidence: `README.md`)
- Voice cloning → Engine API: matches recording (evidence: `README.md`)
- Voice library → Engine API: auditions voices (evidence: `README.md`)
- Engine API → Inference worker: dispatches inference (evidence: `README.md`)
- Inference worker → Kokoro backend: loads backend (evidence: `packages/cadence/src/worker.js`)
- Kokoro backend → ONNX Runtime Web: runs inference (evidence: `README.md`)
- Engine API → Pitch analysis: measures pitch (evidence: `packages/cadence/src/index.js`)
- Engine API → Voice catalog: matches pitch (evidence: `packages/cadence/src/index.js`)
- Voice picker → App state: reads voices (evidence: `apps/web/components/VoicePicker.jsx`)
- Player UI → Audio playback: controls playback (evidence: `apps/web/components/Player.jsx`)
- Voice orb → Audio playback: reads playback level (evidence: `apps/web/components/Orb.jsx`)
- Player UI → Waveform display: renders waveform (evidence: `apps/web/components/Player.jsx`)
