Skip to content

Add Parakeet (HuggingFace) cloud transcription tab (#307)#393

Merged
maboa merged 1 commit into
mainfrom
307-parakeet-huggingface-cloud
Jul 9, 2026
Merged

Add Parakeet (HuggingFace) cloud transcription tab (#307)#393
maboa merged 1 commit into
mainfrom
307-parakeet-huggingface-cloud

Conversation

@maboa

@maboa maboa commented Jul 9, 2026

Copy link
Copy Markdown
Member

Closes #307.

Adds a third Cloud transcription engine: NVIDIA Parakeet TDT 0.6B v3 served through HuggingFace's inference router, called directly from the browser with the user's own HF token — no server.

Verification (the reason #307 is unblocked)

Re-checked against the live endpoint with a real token:

  • The router endpoint is CORS-open (access-control-allow-origin: *).
  • nvidia/parakeet-tdt-0.6b-v3 transcribes via POST router.huggingface.co/together/v1/audio/transcriptions with response_format=verbose_json + timestamp_granularities[]=word.
  • Response shape: { language, duration, text, words:[{ id, word, start, end }] } with start/end in seconds.
  • The earlier concern from huggingface.js#2225 ("Model not supported by provider together") did not reproduce — appears to have been provider/billing-specific; the direct provider path works.

Implementation

  • New js/hyperaudio-lite-editor-parakeet.js (parakeet-hf-service): a single synchronous multipart POST (like Deepgram, not AssemblyAI's poll). Parses the word list (seconds → data-m/data-d). No speaker labels (Parakeet doesn't diarize). Clear errors for invalid token (401/403), quota (402), unreadable media/model (400/422), inference down (5xx), and cross-origin media-fetch failures.
  • 25-language dropdown + Auto-detect (omits the language field).
  • Reuses the eye show/hide, remember-key opt-out and localStorage persistence from the AssemblyAI work. Cloud group is now AssemblyAI · Deepgram · Parakeet (HF) (alphabetical).
  • Version markers → 0.8.2.

Notes

  • Keys live in localStorage in plain text (same trust model as any bring-your-own key); covered by the per-key remember opt-out.
  • URL-mode fetches the media client-side and forwards it as a Blob (the endpoint takes a file, not a URL), so a media host without CORS surfaces a clear "upload the file instead" error.

Third Cloud engine: NVIDIA Parakeet TDT 0.6B v3 via HuggingFace's inference
router, called directly from the browser with the user's own HF token (no
server; endpoint is CORS-open). New js/hyperaudio-lite-editor-parakeet.js does a
single synchronous multipart POST to
router.huggingface.co/together/v1/audio/transcriptions with
response_format=verbose_json + timestamp_granularities[]=word, and parses the
verified { text, words:[{word,start,end}] } shape (seconds -> data-m/data-d).
No diarization. 25-language dropdown + auto-detect.

Reuses the eye show/hide, remember-key opt-out and localStorage persistence from
the AssemblyAI work. Cloud group is now AssemblyAI / Deepgram / Parakeet (HF).

Verified end-to-end against the live endpoint with a real token: the earlier
huggingface.js#2225 "model not supported" concern did not reproduce.
@maboa maboa added the enhancement New feature or request label Jul 9, 2026
@maboa maboa merged commit 9ae6a0c into main Jul 9, 2026
1 check passed
@maboa maboa deleted the 307-parakeet-huggingface-cloud branch July 9, 2026 14:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Parakeet (HuggingFace) as a cloud STT option

1 participant