How krishshripat/vedic-acoustica works
Vedic Acoustica is a web application for analyzing chant and music recordings, not speech transcription. A user authenticates or uploads audio in the React app; Django exposes recording operations and background analysis, whose results are presented as Shruti, Ghana Patha, and raga visualizations. The README documents the three analysis capabilities and corpus ingestion. Some API and task internals are only partially sampled, so the graph omits uncertain details and uses only evidenced or documented relationships.
Main entry points: App.jsx Analysis app · tasks.py Analysis task · views.py Recording API · models.py Recording records
Components 24
Web client
- Analysis app
frontend/src/App.jsx - Authentication
frontend/src/components/AuthScreen.jsx - Auth utilities
frontend/src/utils/auth.js - Audio uploader
frontend/src/components/AudioUploader.jsx - Analysis progress
frontend/src/components/AnalysisProgress.jsx - Shruti views
frontend/src/components/ShrutiMap.jsx - Shruti clusters
frontend/src/components/ClusterPlot.jsx - Ghana visualization
frontend/src/components/GhanaPathaViz.jsx - Raga visualization
frontend/src/components/RagaViz.jsx - Audio playback
frontend/src/components/AudioPlayer.jsx - Spectrogram view
frontend/src/components/SpectrogramView.jsx
API and records
- Recording API
backend/api/views.py - Recording records
backend/api/models.py - API serializers
backend/api/serializers.py - Analysis task
backend/api/tasks.py
Audio analysis
- Feature extraction
backend/ml_engine/audio_processing.py - Shruti assignment
backend/ml_engine/shruti_mapping.py - Shruti clustering
backend/ml_engine/ml_engine.py - Ghana Patha validation
backend/ml_engine/ghana_patha.py - Raga detection
backend/ml_engine/raga_mapping.py
Monitoring and corpus
- Corpus ingestion
backend/api/management/commands/ingest_corpus.py - Metrics endpoint
backend/api/metrics.py
Other components
- Recording user
- Metrics scraper
Connections 27
- Recording user → Analysis app: uses
- Analysis app → Authentication: renders
frontend/src/App.jsx - Analysis app → Audio uploader: renders
frontend/src/App.jsx - Analysis app → Analysis progress: renders
frontend/src/App.jsx - Analysis app → Shruti views: renders
frontend/src/App.jsx - Analysis app → Shruti clusters: renders
frontend/src/App.jsx - Analysis app → Ghana visualization: renders
frontend/src/App.jsx - Analysis app → Raga visualization: renders
frontend/src/App.jsx - Analysis app → Audio playback: renders
frontend/src/App.jsx - Analysis app → Spectrogram view: renders
frontend/src/App.jsx - Analysis app → Auth utilities: uses
frontend/src/App.jsx - Authentication → Auth utilities: stores credentials
frontend/src/components/AuthScreen.jsx - Analysis app → Recording API: requests API
frontend/src/App.jsx - Recording API → Recording records: reads and writes
backend/api/views.py - Recording API → API serializers: serializes records
backend/api/views.py - Recording API → Analysis task: dispatches analysis
backend/api/views.py - Analysis task → Recording records: loads and updates
backend/api/tasks.py - Analysis task → Feature extraction: extracts features
backend/api/tasks.py - Analysis task → Shruti clustering: assigns clusters
backend/api/tasks.py - Analysis task → Ghana Patha validation: validates pattern
backend/api/tasks.py - Analysis task → Raga detection: detects raga
backend/api/tasks.py - Feature extraction → Shruti assignment: uses frequency map
backend/ml_engine/audio_processing.py - Shruti clustering → Shruti assignment: assigns shruti
backend/ml_engine/ml_engine.py - Analysis task → Analysis app: returns analysis results
- Corpus ingestion → Recording records: saves recordings
backend/api/management/commands/ingest_corpus.py - Corpus ingestion → Analysis task: queues analysis
backend/api/management/commands/ingest_corpus.py - Metrics scraper → Metrics endpoint: scrapes metrics