voicegw init - VoiceGateway

Create a voicegw.yaml configuration file from the bundled template.

Synopsis

Scaffold a new config file with example provider, model, and project definitions. Use it when you want a hand-edited starting point. For a guided wizard that also installs the daemon, use voicegw onboard instead. The starter template ships inside the wheel at voicegateway/data/voicegw.example.yaml and is copied verbatim to the output path.

Usage

voicegw init [OPTIONS]

Options

Flag	Short	Type	Default	Description
`--output`	`-o`	`string`	`./voicegw.yaml`	Output path for the generated config file.

Behaviour

If the target file already exists, the CLI prompts for confirmation before overwriting.
The starter template at voicegateway/data/voicegw.example.yaml (inside the installed wheel, resolved via importlib.resources) is written to the output path.

Examples

# Create config in the current directory
voicegw init

# Create config at a custom path
voicegw init --output /etc/voicegateway/voicegw.yaml

# Create config with the short flag
voicegw init -o ~/projects/my-agent/voicegw.yaml

# Overwrite an existing config (prompts for confirmation)
voicegw init --output ./voicegw.yaml
# Prompts: "./voicegw.yaml already exists. Overwrite? [y/N]"

After running init

Open the generated file in your editor and add your API keys.
Configure models under the models: section.
Verify the config with voicegw status.

voicegw onboard | voicegw status | voicegw serve | Configuration reference