parakeet-local-asr

Original source / Raw SKILL.md

---
name: parakeet-local-asr
description: Install and operate local NVIDIA Parakeet ASR for OpenClaw with an OpenAI-compatible transcription API on Ubuntu/Linux and macOS (Intel/Apple Silicon). Use when the user wants private/local speech-to-text, voice transcription setup, ASR troubleshooting, or OpenClaw voice stack configuration with Parakeet (and optional Whisper fallback).
---

# Parakeet Local ASR

Run local Parakeet ASR in a deterministic way.

## Standard workflow

1. Install/update runtime:
   ```bash
   bash scripts/bootstrap.sh
   ```
2. Start service:
   ```bash
   bash scripts/start.sh
   ```
3. Validate service health:
   ```bash
   bash scripts/healthcheck.sh
   ```
4. (Optional) Run a smoke transcription test with a local audio file:
   ```bash
   bash scripts/smoke-test.sh /path/to/audio.mp3
   ```

## Repo location

Default install/update path used by scripts:
- `~/parakeet-asr`

Override with env var before running scripts:
```bash
PARAKEET_DIR=/custom/path bash scripts/bootstrap.sh
```

## OpenClaw integration notes

After healthcheck passes, use:
- URL: `http://localhost:9001`
- Endpoint: `/v1/audio/transcriptions`

If a user requests reliability over purity, keep Whisper as fallback provider.

## Safety rules

- Ask before elevated/package-manager operations.
- Do not kill unrelated processes.
- Keep changes scoped to ASR setup unless explicitly asked.


---

## Referenced Files

> The following files are referenced in this skill and included for context.

### scripts/bootstrap.sh

```bash
#!/usr/bin/env bash
set -euo pipefail

PARAKEET_DIR="${PARAKEET_DIR:-$HOME/parakeet-asr}"
REPO_URL="${PARAKEET_REPO_URL:-https://github.com/rundax/parakeet-asr.git}"

if [ -d "$PARAKEET_DIR/.git" ]; then
  echo "Updating existing repo at $PARAKEET_DIR"
  git -C "$PARAKEET_DIR" pull --ff-only
else
  echo "Cloning repo to $PARAKEET_DIR"
  git clone "$REPO_URL" "$PARAKEET_DIR"
fi

cd "$PARAKEET_DIR"
./setup.sh

echo "Bootstrap complete"

```

### scripts/start.sh

```bash
#!/usr/bin/env bash
set -euo pipefail

PARAKEET_DIR="${PARAKEET_DIR:-$HOME/parakeet-asr}"

if [ ! -x "$PARAKEET_DIR/start-parakeet.sh" ]; then
  echo "start-parakeet.sh not found in $PARAKEET_DIR"
  echo "Run: bash scripts/bootstrap.sh"
  exit 1
fi

cd "$PARAKEET_DIR"
./start-parakeet.sh

```

### scripts/healthcheck.sh

```bash
#!/usr/bin/env bash
set -euo pipefail

URL="${PARAKEET_URL:-http://localhost:9001/health}"

echo "Checking $URL"
resp="$(curl -fsS "$URL")"
echo "$resp"

echo "$resp" | grep -q '"status":"healthy"\|"status": "healthy"'
echo "Healthcheck OK"

```

### scripts/smoke-test.sh

```bash
#!/usr/bin/env bash
set -euo pipefail

if [ "$#" -lt 1 ]; then
  echo "Usage: $0 /path/to/audio-file"
  exit 1
fi

AUDIO_PATH="$1"
URL="${PARAKEET_URL:-http://localhost:9001/v1/audio/transcriptions}"

if [ ! -f "$AUDIO_PATH" ]; then
  echo "Audio file not found: $AUDIO_PATH"
  exit 1
fi

curl -fsS -X POST "$URL" \
  -F "file=@$AUDIO_PATH" \
  -F "model=parakeet-tdt-0.6b-v3"
echo

```



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "hantok",
  "slug": "parakeet-local-asr",
  "displayName": "Parakeet Local Asr",
  "latest": {
    "version": "0.1.0",
    "publishedAt": 1771611250718,
    "commit": "https://github.com/openclaw/skills/commit/f1a5d8dd2a940026076cafc95fc7bdf0bb8f7533"
  },
  "history": []
}

```