Setup Wizard

The whisp init command provides an interactive setup wizard that guides you through configuration.

Running the Wizard

whisp init

The wizard walks you through:

Selecting an AI provider
Configuring your API key
Starting the daemon

Provider Selection

Welcome to Whisp Setup!

Select your AI provider:

  1. OpenAI        (gpt-5-nano, gpt-4o)
  2. Anthropic     (Claude Sonnet, Opus, Haiku)
  3. Ollama        (Local - llama3.2, mistral, codellama)
  4. Google Gemini (gemini-1.5-flash, gemini-1.5-pro)
  5. Cerebras      (Fast inference)

Enter choice [1-5]:

OpenAI

Enter choice [1-5]: 1

OpenAI selected.
Default model: gpt-5-nano-2025-08-07

Enter your OpenAI API key: sk-••••••••••••••••

Configuration saved to ~/.config/whisp/config.toml

Start the daemon now? [Y/n]: y
Daemon started successfully!

Anthropic

Enter choice [1-5]: 2

Anthropic Claude selected.
Default model: claude-sonnet-4-20250514

Enter your Anthropic API key: sk-ant-••••••••••••••••

Configuration saved to ~/.config/whisp/config.toml

Ollama (Local)

Enter choice [1-5]: 3

Ollama selected (local AI - no API key needed).
Default model: llama3.2

Checking Ollama connection at http://localhost:11434...
✓ Ollama is running

Available models:
  - llama3.2 (default)
  - codellama
  - mistral

Configuration saved to ~/.config/whisp/config.toml

Google Gemini

Enter choice [1-5]: 4

Google Gemini selected.
Default model: gemini-1.5-flash

Enter your Google API key: ••••••••••••••••

Configuration saved to ~/.config/whisp/config.toml

Cerebras

Enter choice [1-5]: 5

Cerebras selected.
Default model: gpt-oss-120b

Enter your Cerebras API key: csk-••••••••••••••••

Configuration saved to ~/.config/whisp/config.toml

Verifying Setup

Check your configuration without making changes:

whisp init --check

Output:

Whisp Setup Verification
────────────────────────
✓ Config file exists at ~/.config/whisp/config.toml
✓ Provider: openai
✓ Model: gpt-5-nano-2025-08-07
✓ API key configured
✓ Daemon is running

Setup is complete!

If there are issues:

Whisp Setup Verification
────────────────────────
✓ Config file exists at ~/.config/whisp/config.toml
✓ Provider: anthropic
✗ API key not configured

Run 'whisp init' to fix configuration.

Re-running Setup

You can run whisp init again anytime to:

Switch providers
Update your API key
Reconfigure settings

The wizard will update your existing config file.

What the Wizard Creates

Config File

# ~/.config/whisp/config.toml
default_provider = "openai"

[providers.openai]
api_key = "sk-..."
model = "gpt-5-nano-2025-08-07"

File Permissions

The wizard sets secure permissions automatically:

chmod 600 ~/.config/whisp/config.toml

API Key Input

The wizard masks your API key as you type for security:

Enter your OpenAI API key: ••••••••••••••••

It also validates the key format:

OpenAI: Must start with sk-
Anthropic: Must start with sk-ant-
Cerebras: Must start with csk-

After Setup

Once setup completes:

Shell integration: Add to your shell rc file if not already done:

# For bash (~/.bashrc)
eval "$(whisp shell init bash)"

# For zsh (~/.zshrc)
eval "$(whisp shell init zsh)"

# For fish (~/.config/fish/config.fish)
whisp shell init fish | source

Test it works:
```
, list files in current directory
```
Check status:
```
whisp status
```

Troubleshooting

"Invalid API key format"

Ensure your key matches the expected format:

OpenAI: sk-...
Anthropic: sk-ant-...
Cerebras: csk-...

"Ollama not running"

Start Ollama first:

ollama serve

Then re-run whisp init.

"Permission denied" when saving config

Ensure you have write access:

mkdir -p ~/.config/whisp
whisp init

Daemon won't start after setup

Check for issues:

whisp doctor

Common fixes:

Remove stale socket: rm /tmp/whisp.sock
Remove stale PID: rm /tmp/whisp.pid
Check logs: whisp start --foreground