parakeet-local-asr

在 Ubuntu/Linux 和 macOS（Intel/Apple Silicon）上使用兼容 OpenAI 的转录 API 安装和操作适用于 OpenClaw 的本地 NVIDIA Parakeet ASR。当用户需要私人/本地语音转文本、语音转录设置、ASR 故障排除或使用 Parakeet（以及可选的 Whisper 回退）进行 OpenClaw 语音堆栈配置时使用。

# 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.

---

## 中文说明

# Parakeet 本地 ASR

以确定性的方式运行本地 Parakeet ASR。

## 标准工作流程

1. 安装/更新运行时：
   ```bash
   bash scripts/bootstrap.sh
   ```
2. 启动服务：
   ```bash
   bash scripts/start.sh
   ```
3. 验证服务健康状况：
   ```bash
   bash scripts/healthcheck.sh
   ```
4. （可选）使用本地音频文件运行一次冒烟转录测试：
   ```bash
   bash scripts/smoke-test.sh /path/to/audio.mp3
   ```

## 仓库位置

脚本使用的默认安装/更新路径：
- `~/parakeet-asr`

在运行脚本前可通过环境变量覆盖：
```bash
PARAKEET_DIR=/custom/path bash scripts/bootstrap.sh
```

## OpenClaw 集成说明

健康检查通过后，使用：
- URL：`http://localhost:9001`
- 端点：`/v1/audio/transcriptions`

如果用户要求可靠性优先于纯粹性，可保留 Whisper 作为回退提供方。

## 安全规则

- 在执行提权/包管理器操作前先询问。
- 不要终止无关进程。
- 除非明确要求，否则将改动范围限定在 ASR 设置内。