---
title: Rhythma
emoji: 🎧
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 6.12.0
app_file: app.py
pinned: true
license: apache-2.0
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/64628a722a83863b97beed5e/y4bWysnsPMV2asL_LFB9X.jpeg
short_description: Reflective listening sessions for calm and focus
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

## Rhythma

Rhythma is an artful wellness companion that translates a felt state into a named listening session.
The app pairs session profiling, layered audio, and reflective copy so the experience feels closer to a guided ritual than a parameter dashboard.

## Local Development

Install the dependencies, then run the Gradio app:

```bash
pip install -r requirements.txt
python app.py
```

Set `GROQ_API_KEY` to enable Groq-backed text classification and voice-note transcription.

If `gradio` is not installed locally, you can still run the focused test suite for `app.py` through the stubbed UI tests in `tests/test_rhythma_ui_copy.py`.

## Session-Led Experience

- The main prompt asks what you are carrying or what intention you want to hold.
- The output surface now leads with a named session and emotional tone before the listening guidance appears.
- `Tone Center` and `Session Pattern` can stay on automatic or be gently overridden from the session controls.
- The output area is framed around `Your Listening Path`, `Session Reflection`, audio playback, and waveform views.
- Example prompts now reflect a calmer, artful wellness voice rather than a technical modulation demo.

## Project Structure

- `app.py`: session-led Gradio interface and request pipeline
- `rhythma_engine.py`: waveform generation, audio export, and visualization
- `rhythma_analysis.py`: text/audio analysis, optional Groq integration, and session-profile shaping
- `rhythma.py`: compatibility facade for the public classes
- `tests/test_rhythma_regression.py`: regression tests for the core behavior
- `tests/test_rhythma_ui_copy.py`: focused UI-copy tests that avoid a real Gradio import