Spaces:
Running
Running
File size: 2,116 Bytes
a68e8cf 118f06a 1ad671f 118f06a ed238e8 267c544 118f06a a68e8cf bb88d70 c6a5091 23242ba f1cfb8f ed238e8 a68e8cf b27118b 1ad671f b27118b 1ad671f b27118b 1ad671f b27118b 1ad671f b27118b 118f06a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 | ---
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 |