deyo

@casatwy/deyo installs the deyo command for sending transcription jobs to Deyo from your terminal.

Install

npm install -g @casatwy/deyo

pnpm add -g @casatwy/deyo

First-time login

Create a Deyo API key from https://deyo.miaobi.fun/me/api-keys, then save it once locally:

deyo auth login --api-key 'deyo_sk_xxx'

Check whether the local config is active:

deyo auth status

Remove the saved local config:

deyo auth logout

Usage

The published CLI defaults to the production service at https://deyo.miaobi.fun.

After deyo auth login, you can run transcription commands without repeating --api-key:

deyo --language zh -O ./transcript.txt 'https://www.bilibili.com/video/BVxxxx'

deyo --language zh --format srt -O ./transcript.srt 'https://www.youtube.com/watch?v=xxxx'

deyo --language en 'https://www.youtube.com/watch?v=xxxx'

If you need local development, pass --base-url explicitly:

deyo auth login --api-key 'deyo_sk_xxx' --base-url 'http://deyo.mac-studio'
deyo --base-url 'http://deyo.mac-studio' --language zh -O ./transcript.txt 'https://www.bilibili.com/video/BVxxxx'

For a one-off override, --api-key still takes precedence over local config:

deyo --api-key 'deyo_sk_other' --language zh 'https://www.youtube.com/watch?v=xxxx'

By default, the CLI requests Chinese output, which is equivalent to --language zh.

Run deyo --help to see the full argument list.

Install in AI tools

The official install pages live at:

• Codex: https://deyo.miaobi.fun/ai/install/codex
• Claude: https://deyo.miaobi.fun/ai/install/claude

These pages tell the AI how to install the deyo skill or plugin, ask for the user's API key once, and run deyo auth login locally.

Publish

For maintainers, publish from the cli_ directory:

cd cli_
make deploy

If you need to publish a new version, pass it explicitly:

cd cli_
make deploy VERSION=0.1.1

With npm 2FA enabled, pass the current OTP code explicitly:

cd cli_
make deploy OTP=123456