# Prepare a JackAILocal USB drive from zero

## Real product behavior

JackAILocal must be prepared before delivery or before offline use. The customer must not download models when the drive is inserted. Models are copied or downloaded during manufacturing, then read locally from the drive.

Normal customer flow:

```text
insert the USB/SSD drive into Windows
open the drive
double-click START-HERE.cmd
JackAILocal starts locally
browser opens http://127.0.0.1:4891
```

## Recommended hardware

Serious product minimum:

```text
USB 3.2 SSD or external NVMe
128 GB minimum
256 GB recommended
separate SSD or dedicated image for Linux boot mode
```

Avoid cheap low-speed USB sticks. They increase first-load time and support cost.

## Factory prerequisites

On the factory/build computer:

```text
Windows 10/11
PowerShell 5+
Rust toolchain if building jackailocald.exe locally
Ollama Windows binary
llama.cpp llama-server.exe binary
Internet access only during preparation/model download
```

## Prepare the backend cache

Recommended cache layout:

```text
C:\\JackAILocalBackendCache\\
├── ollama.exe
└── llama-server.exe
```

Keep fixed, audited backend versions in the cache. Do not use floating versions for shipped drives.

## Prepare the drive

```powershell
powershell -ExecutionPolicy Bypass -File .\\factory\\powershell\\Prepare-JackAILocalUSB.ps1 `
  -TargetDrive "E:\\" `
  -BackendCache "C:\\JackAILocalBackendCache" `
  -ModelSet balanced
```

Options:

```powershell
-ModelSet lite
-ModelSet balanced
-ModelSet full
-SkipModels
-SkipRustBuild
-UseSystemOllamaAsSource
```

## Offline acceptance test

1. Disconnect the network or enable airplane mode.
2. Insert the prepared drive.
3. Run `START-HERE.cmd`.
4. Confirm that the UI opens.
5. Send a short chat prompt.
6. Open Models and confirm the catalog loads.
7. Open Support and prepare a report.
8. Confirm that no model download is attempted during normal use.

## Expected customer-ready state

Required files:

```text
START-HERE.cmd
bin\\jackailocald.exe
backends\\ollama\\windows\\ollama.exe
models\\ollama\\...
webui\\index.html
config\\model-catalog.json
manifest\\sha256-manifest.json
```

Do not ship a drive with placeholder backend files unless it is clearly labeled as a developer kit.

## Claims to avoid

Do not claim:

```text
automatic execution when inserted
zero trace on the Windows host
perfect GPU compatibility on every PC
unbreakable anti-copy protection
```

Safe claim:

```text
Insert the drive, open it, double-click START-HERE, and use local AI without installation after the drive has been prepared.
```