> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hopx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup Wizard

> Interactive setup wizard for first-time HopX CLI configuration. Guides you through authentication, API key creation, and initial configuration.

Run the interactive setup wizard using the `init` command. This guides you through first-time CLI configuration including authentication, API key creation, and initial settings.

## Command Syntax

```bash theme={null}
hopx init [OPTIONS]
```

## Options

* `--no-browser` - Headless mode: manually paste callback URL (for servers without browsers)
* `--skip-test` - Skip the sandbox test step

## Description

The `init` command is an interactive setup wizard that helps you configure the HopX CLI for first-time use. It guides you through:

1. **Authentication** - Browser-based OAuth login
2. **API Key Creation** - Create and store your first API key
3. **Configuration** - Set default settings
4. **Verification** - Test your connection (unless `--skip-test` is used)

## Examples

```bash theme={null}
# Full interactive setup
hopx init

# Headless mode (for servers without browsers)
hopx init --no-browser

# Skip the sandbox test
hopx init --skip-test
```

**Expected Output:**

```
Welcome to HopX CLI Setup
✓ Opening browser for authentication...
✓ Authentication successful
✓ Creating API key...
✓ API key created and stored
✓ Configuration complete
✓ Testing connection...
✓ Setup complete!
```

## When to Use

* **First-time setup** - Run `hopx init` after installing the CLI
* **Reconfiguration** - Run `hopx init` to reconfigure your CLI settings
* **New environment** - Run `hopx init` when setting up on a new machine

## Manual Setup Alternative

If you prefer manual setup, you can configure the CLI step by step:

```bash theme={null}
# Authenticate
hopx auth login

# Create API key
hopx auth keys create --name "my-key"

# Configure settings
hopx config set default_template python
```

## Related

* **[CLI Installation](/cli/installation)** - Install the CLI
* **[CLI Quickstart](/cli/quickstart)** - Get started guide
* **[Authentication](/cli/commands/auth)** - Authentication commands
* **[Configuration](/cli/commands/config)** - Configuration commands

## Next Steps

* Complete [CLI Quickstart](/cli/quickstart) to run your first command
* Learn about [Authentication](/cli/commands/auth) for API key management
* Explore [Configuration](/cli/commands/config) to customize CLI settings