audiocpp-asr-extended

name	audiocpp-asr-extended
description	Transcription beyond the GuideAnts wrapper contract: transcribe workspace files by path (no upload, no 50 MB gateway cap), pass language hints, and sideload other qwen3-family ASR snapshots from Hugging Face through the wrapper. Use when a transcription needs a language hint, the file is large, or the user wants to try an ASR model the catalog doesn't list.
metadata	{"guideants":{"enabled":true,"display_order":33,"requires_toolsets":["sandbox"]}}

audio.cpp extended ASR (experimental)

The GuideAnts ASR wrapper (127.0.0.1:8082) takes multipart uploads with no language control. The raw engine it spawns (127.0.0.1:18082) accepts a server-local path and a language hint — and the sandbox shares its filesystem, so any workspace file qualifies. The wrapper also loads bare model directories the catalog doesn't list (unlike the strictly-gated TTS wrapper).

Preflight

python3 Output/Skills/audiocpp-asr-extended/scripts/preflight.py --for asr-extended

Trust its verdict over this document. open: false means no ASR model is loaded — ask the user to load one via GuideAnts Settings → Local models. Warnings tell you whether the sideload path (below) is available.

Transcribing by path (with language hint)

python3 Output/Skills/audiocpp-asr-extended/scripts/engine_tool.py transcribe \
  Output/uploads/clip.wav [--language de]

• No upload and no gateway size cap — the engine reads the file in place.
• The engine model id is always qwen3-asr (fixed by the wrapper), whatever snapshot is actually loaded.
• Input should be WAV for the raw engine; for other formats, either convert with ffmpeg first or use the wrapper upload (POST :8082/transcribe, multipart field audio), which re-encodes to 16 kHz mono itself.

Sideloading a non-catalog ASR snapshot

The ASR wrapper's /admin/load accepts any bare directory under /models-local/asr whose leaf name matches the model_id. The engine family defaults to qwen3_asr, so only qwen3_asr-family snapshots work (other families would need the GA_ASR_ENGINE_FAMILY env at service start — a compose change, out of skill scope).

python3 Output/Skills/audiocpp-asr-extended/scripts/fetch_model.py <hf-repo-id> \
  --dest /models-local/asr/<DirName>
curl -s -X POST http://127.0.0.1:8082/admin/load \
  -H "Content-Type: application/json" -d '{"model_id": "<DirName>"}'

Warning — this replaces the user's loaded ASR model. Ask before doing it, and offer to restore afterwards:

curl -s -X POST http://127.0.0.1:8082/admin/load \
  -H "Content-Type: application/json" -d '{"model_id": "qwen3_asr_0_6b"}'

Note: GuideAnts' desired-state reconciler owns wrapper load state — a sideload can be silently undone by a later reconcile (e.g. after a local-LLM switch). Treat sideloads as session-scoped experiments, not durable configuration.

Related

Speaker-labeled transcripts ("who said what") are the audiocpp-diarize skill.

Reporting

End by telling the user what worked and what was blocked, quoting the preflight/engine evidence.