# Quickstart Guide

This guide helps you create your first VTAP100 configuration in minutes.

## Installation

```bash
# With uv (recommended)
uv sync

# Alternatively with pip
pip install -e .
```

## Fastest Method: CLI

### Apple VAS Configuration

```bash
vtap100 generate --apple-vas pass.com.example.myapp --key-slot 1
```

### Google Smart Tap Configuration

```bash
vtap100 generate --google-st 96972794 --key-slot 2 --key-version 1
```

### Combined Configuration

```bash
vtap100 generate \
  --apple-vas pass.com.example.myapp \
  --google-st 96972794 \
  --key-slot 1
```

## Interactive Wizard

For a guided configuration:

```bash
vtap100 wizard
```

## Python API

```python
from vtap100.models.config import VTAPConfig
from vtap100.models.vas import AppleVASConfig
from vtap100.models.keyboard import KeyboardConfig
from vtap100.generator import ConfigGenerator

# Create configuration
vas = AppleVASConfig(
    merchant_id="pass.com.example.myapp",
    key_slot=1,
)
kb = KeyboardConfig(log_mode=True, source="A1")

config = VTAPConfig(
    vas_configs=[vas],
    keyboard=kb,
)

# Generate config.txt
generator = ConfigGenerator(config)
print(generator.generate())

# Save to file
generator.write_to_file("config.txt")
```

## Example Output

```ini
!VTAPconfig
; Generated by VTAP100 CLI
; Apple VAS Configuration
VAS1MerchantID=pass.com.example.myapp
VAS1KeySlot=1
; Keyboard Emulation
KBLogMode=1
KBSource=A1
```

## Transfer Configuration to Reader

1. Connect VTAP100 via USB
2. Reader appears as USB drive
3. Copy `config.txt` to the drive
4. Optional: Add `private1.pem` key file
5. Restart reader (disconnect/reconnect USB)

## Parameter Help

```bash
# Show all parameters
vtap100 docs

# CLI help
vtap100 --help
vtap100 generate --help
```

## Next Steps

- [Apple VAS Configuration](configuration/apple_vas.md)
- [Google Smart Tap Configuration](configuration/google_smarttap.md)
- [Keyboard Emulation](configuration/keyboard.md)
- [Deployment](deployment/upload_to_reader.md)
