stt

Files (1)

• SKILL.md

SKILL.md (first lines)

# stt — speech transcription via LocalKin Service Audio (SenseVoice)

Wraps the LocalKin Service Audio API at `:8000/transcribe`. Multipart
upload with one `file` field, returns `{"text", "language", "confidence"}`.

## Why this is a SKILL.md and not a native skill

It's a single multipart curl + jq extraction. Pure HTTP wrapper, no
state, no OS API binding — perfect external skill territory.

## Pairing with `record`

```
record action=start audio=false mic=true   → returns recording_id
... user speaks ...
record action=stop id=<recording_id>        → returns path: ~/.../rec-XXXX.mp4
stt path=~/.../rec-XXXX.mp4                 → returns the spoken text
```

The mp4 from `record` has its mic audio in a track that SenseVoice
reads directly — no ffmpeg extraction needed.

## Override the endpoint

```bash
STT_ENDPOINT=http://otherbox:8000 kinclaw -soul souls/pilot.soul.md
```

## Failure modes

- `stt: path required` / `stt: file not found` — caller-side argument problems.
- `stt: server returned HTTP ...` — server up but rejected; body is echoed.
- Connection refused — server isn't running on the configured port.

From LocalKinAI/kinclaw, Apache-2.0.

More from LocalKinAI/kinclaw