add whisper.cpp integration for AI-167 mobile STT evaluation - #90
add whisper.cpp integration for AI-167 mobile STT evaluation#90akshhkaushik wants to merge 16 commits into
Conversation
…king Add whisper.cpp as git submodule with setup documentation and minimal evaluation runner for AI-167 (multilingual support evaluation). Changes: - evaluation/whisper.cpp: C/C++ Whisper for on-device mobile inference - evaluation/SETUP.md: Build and setup instructions - evaluation/run_multilingual_eval.py: Thin wrapper to run benchmarks This enables evaluation of whisper-tiny, whisper-base, and whisper-small across 5 languages (en, hi, es, fr, de) with focus on mobile performance metrics: WER, CER, latency, model size, memory usage. Addresses: AI-167
Add docstrings and section headers explaining: - Why whisper.cpp was chosen over Python/HuggingFace (mobile focus) - Key design decisions (minimal code, validate state, use existing tools) - Collaborative refinement with Claude Opus 4.5 This makes the contribution more human and transparent about the thought process, not just presenting final code.
…dback Per Pronay Sarker's guidance, add comprehensive results documentation that includes: - Jira ticket reference (AI-167) - Repository link for mentor review and reproduction - Reproduction steps - Results template (WER/CER, latency, model size) - Findings section for analysis - Next steps for follow-up work This provides mentors with a single source of truth for: 1. How to access the work 2. How to reproduce it 3. Where findings will be documented
There was a problem hiding this comment.
Pull request overview
Adds whisper.cpp as a submodule and introduces initial tooling/docs to run a multilingual STT evaluation (AI-167) using whisper.cpp’s benchmarking utilities.
Changes:
- Added
whisper.cppgit submodule underevaluation/. - Added a Python runner script intended to orchestrate benchmarking.
- Added setup + results documentation for reproducing and recording benchmarks.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| evaluation/whisper.cpp | Adds the whisper.cpp submodule pointer to a specific commit. |
| .gitmodules | Registers the whisper.cpp submodule path + URL. |
| evaluation/run_multilingual_eval.py | Introduces a wrapper script to run whisper.cpp benchmarking. |
| evaluation/SETUP.md | Documents build/run steps for the evaluation. |
| evaluation/RESULTS.md | Adds a results template and reproduction steps for AI-167. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Added a note about using AI model Claude Opus 4.6 for refinement.
Refine script with insights from Claude Opus 4.5 and related benchmarks.
Modified the benchmarking process to iterate over multiple models, running benchmarks for each model individually.
- Add llms.txt for Claude/AI tool compatibility - Add SKILL.md defining /benchmark-speech and /evaluate-language workflows - Add Deepgram STT provider wrapper with async streaming - Add WER/CER metrics calculation for accuracy measurement - Add language targets (English, Spanish, Hindi, Swahili, French, Portuguese) Total: 426 lines across 5 focused files
|
please remove AI dev files (skills, llms.txt etc) |
|
CLA check ok |
Removed the section for the next PR regarding the evaluation runner.
deleted skills, llms.txt |
|
Please let me know if any another changes are required |
|
Just rename the results file to something like results_whisper |
done |
|
@aksh08022006 is this needed or have you covered this in #99 ? |
|
showing conflicts too |
resolved the conflicts. |
What
Add whisper.cpp (C/C++ optimized Whisper) as the foundation for evaluating
multilingual STT support on mobile devices.
Jira Ticket: AI-167 - Evaluate multilingual support for smallest ai
implementation of whisper.cpp
whisper-benchfor measuring inference speedWhat's included
evaluation/whisper.cpp/: Git submodule (C/C++ Whisper implementation)evaluation/SETUP.md: Step-by-step build & run instructionsevaluation/run_multilingual_eval.py: Minimal wrapper scriptevaluation/RESULTS.md: Documentation hub for findings & reproduction⚙️ Development & Code Accountability
AI Model Used: Claude Opus 4.5 (via GitHub Copilot)
What Claude was used for:
Full Accountability
All code in this PR remains under complete human(my) responsibility.
How to Reproduce