# Windows Setup Guide

Recommended approach: use WSL2 (Ubuntu) for best compatibility.

## Option A: WSL2 (Recommended)

1. Install WSL2 and Ubuntu.
2. Open Ubuntu terminal and follow Linux guide in docs/README.linux.md.
3. Clone and run from WSL filesystem.

## Option B: Native PowerShell

Native mode is possible but some shell/macOS-specific commands will not work.

### 1) Install tools

- Install Python 3.11+
- Install Git
- Install optional tools (ollama, adb) if needed

### 2) Create environment

In repository root (PowerShell):
- py -3 -m venv .venv
- .\.venv\Scripts\Activate.ps1
- py -3 -m pip install --upgrade pip

### 3) Create secrets file

Create this file manually (Windows equivalent of ~/.zshrc.secrets), for example:
- C:\Users\<you>\.zshrc.secrets

Copy values from config/zshrc.secrets.example and set real keys.

### 4) Run

- py -3 jarvis_ai.py --status
- py -3 jarvis_ai.py --text
- py -3 jarvis_ai.py --telegram-bot

## Windows Caveats

- AppleScript/macOS control commands are unavailable.
- Some zsh aliases and functions in .zshrc are not native to PowerShell.
- Prefer WSL2 for full command compatibility.