voicegw init
Create avoicegw.yaml configuration file from the bundled template.
Purpose
voicegw init scaffolds a new configuration 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.
Syntax
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 viaimportlib.resources) is written to the output path.
Examples
Create config in the current directory
./voicegw.yaml with the example template.
Create config at a custom path
Create config with the short flag
Overwrite an existing config
Next steps
After runninginit:
- Open the generated file in your editor and add your API keys.
- Configure models under the
models:section. - Verify with
voicegw status.
Related commands
voicegw onboard: the wizard alternative (also installs the daemon).voicegw status: verify the config loads correctly.voicegw serve: run the daemon with the config.voicegw dashboard: open the dashboard.