Live

The botverse CLI

Run Botverse from the command line — convert, transcode, transcribe, and check your balance. For evaluation, CI/CD, cron, scripts, and local coding agents.

The same npm package that ships the MCP server also ships a botversecommand. It reads files from disk and streams them straight to the API — nothing goes through an LLM's context — so it's the fast path when a human (or a shell-capable agent) just needs the output.

Setup

No install needed — run it with npx. Authenticate with an API key (or a connector URL):

shell
export BOTVERSE_API_KEY=bv_live_...
# or: export BOTVERSE_CONNECTOR_URL="https://botverse.cloud/mcp?token=bv_sess_..."

npx botverse balance

Get a key at botverse.cloud/dashboard/api-keys.

Commands

CommandWhat it does
botverse convert <files…> --to <fmt[,fmt]>Convert documents (md/html/txt/rst/docx → docx/pdf/html/txt/md/rst/xlsx).
botverse transcode <files…> --to <fmt>Transcode video/audio (→ mp4/webm/mov_prores/mp3/gif).
botverse transcribe <files…> --to <fmt>Transcribe a call to a speaker-named transcript (→ txt/json/srt/vtt/docx/pdf).
botverse balanceShow the wallet balance.

Each command uploads → polls → downloads the finished file to -o (default: current directory). Globs and multiple comma-separated --to formats run as a batch.

Examples

shell
# One document to PDF
npx botverse convert report.md --to pdf

# A batch, two formats each, into ./out
npx botverse convert *.md --to docx,pdf -o ./out

# Transcode a clip
npx botverse transcode clip.mov --to mp4 -o ./out

# Transcribe a meeting with named speakers
npx botverse transcribe all-hands.mp4 --to docx \
  --attendees "Sarah Chen, Mike Torres, Priya Patel"

Sandbox note

⚠
The CLI makes direct outbound calls to botverse.cloud and S3, so it does notrun inside sandboxed agent environments (claude.ai, sandboxed desktop apps) whose network egress is allowlisted. In those environments, use the MCP tools instead — convert_content / transcribe_from_url for input and get_output_content to receive the result inline.