Metadata-Version: 2.4
Name: deepflow-voicespeed-cli
Version: 0.1.3
Summary: Command line client for VoiceSpeed OpenAPI
Home-page: https://github.com/DeepFlowAI/voicespeed
License: Proprietary
Keywords: voicespeed,deepflow,cli,openapi
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# deepflow-voicespeed-cli

Command line client for VoiceSpeed OpenAPI.

## Install

```bash
pip install deepflow-voicespeed-cli
```

## Configure

```bash
export VOICESPEED_BASE_URL=http://localhost:5002
export VOICESPEED_API_KEY=YOUR_API_KEY
```

Both values can also be passed with `--base-url` and `--api-key`.

## Usage

```bash
voicespeed agents list --status enabled
voicespeed agents create --name "Support" --description "Demo agent"
voicespeed agents update 1 --name "Support Pro"
voicespeed agents disable 1
voicespeed agents enable 1
voicespeed agents basic-settings 1
voicespeed agents update-basic-settings 1 --prompt "You are a support assistant."
voicespeed agents update-basic-settings 1 --prompt-file prompt.txt \
  --opening-mode fixed_greeting --greeting "Hello, how can I help?"
voicespeed conversation run 1 --message "Hello" --mode text2text \
  --variables '{"customer_name":"Ada"}'
voicespeed calls preset-variables 1 call_42 \
  --variables '{"customer_name":"Ada","order_no":"A1024"}'
voicespeed realtime-sessions create 1 --external-id call_42 \
  --variables '{"customer_name":"Ada"}'
```

`agents update-basic-settings` changes only the fields passed on the command line. Use `--prompt-file`, `--runtime-context-file`, or `--greeting-file` for long text.

`--variables` is a JSON object of text values. It is optional on `conversation run` and `realtime-sessions create`. `calls preset-variables` stores values for a FlowKit call before it starts; the call id is the same value later sent as `session_id`.

All successful commands print formatted JSON.
