How achyantsh/gnani-task works
AudioNote is an audio-notes web application whose main workflow is browser upload to R2, asynchronous transcription through Gnani, language-aware summarization, and saved results users can revisit. The graph separates the frontend experience, backend orchestration, external providers, and persistence/authentication. Backend service calls and the sampled auth callback are supported by excerpts; several frontend-to-service relationships and history details are documented in the README, while unsampled implementation specifics are not inferred.
Main entry points: transcription.py Job orchestration · dropzone.tsx Upload and progress · transcribe.ts Transcription action · page.tsx Transcription history
Components 22
Frontend experience
- Home experience
frontend/app/page.tsx - Upload and progress
frontend/components/home/hero/dropzone.tsx - Upload action
frontend/actions/upload.ts - Transcription action
frontend/actions/transcribe.ts - Transcript and summary
frontend/components/home/hero/result-card.tsx - Audio playback
frontend/components/home/hero/audio-player.tsx - Transcription history
frontend/app/transcriptions/page.tsx - History list
frontend/components/transcriptions/transcription-list.tsx - History action
frontend/actions/transcriptions.ts - Sign-in interface
frontend/app/(auth)/login/page.tsx - Auth callback
frontend/app/auth/callback/route.ts
Backend processing
- FastAPI application
backend/main.py - Job orchestration
backend/routes/transcription.py - R2 signing
backend/services/r2.py - Gnani client
backend/services/gnani.py - Summary generation
backend/services/summary.py
External providers
- Cloudflare R2
- Gnani Batch STT
- Google Gemini
Identity and records
- Supabase records
- Supabase Auth
Other components
- User
Connections 24
- User → Home experience: uses
- Home experience → Upload and progress: offers upload
- Upload and progress → Upload action: requests URL
- Upload action → Cloudflare R2: uploads audio
- Upload and progress → Transcription action: starts job
- Transcription action → FastAPI application: calls API
- FastAPI application → Job orchestration: routes requests
backend/main.py - Job orchestration → R2 signing: requests signed URL
backend/routes/transcription.py - R2 signing → Cloudflare R2: signs read URL
- Job orchestration → Gnani client: manages job
backend/routes/transcription.py - Gnani client → Gnani Batch STT: creates and polls
backend/services/gnani.py - Transcription action → Job orchestration: polls status
- Job orchestration → Summary generation: summarizes transcript
backend/routes/transcription.py - Summary generation → Google Gemini: generates summary
backend/services/summary.py - Job orchestration → Supabase records: saves completed result
backend/routes/transcription.py - Job orchestration → Transcript and summary: returns completed result
- Transcript and summary → Audio playback: renders playback
frontend/components/home/hero/result-card.tsx - User → Transcription history: revisits recordings
- Transcription history → History list: shows recordings
- Transcription history → History action: loads history
- History action → Supabase records: reads records
- User → Sign-in interface: signs in
- Sign-in interface → Supabase Auth: authenticates
- Auth callback → Supabase Auth: exchanges code
frontend/app/auth/callback/route.ts