docs/FACTORY_OVERVIEW.md

Factory Overview

Goal

Produce a USB/SSD that works immediately when inserted into a Windows machine and also has an optional Linux boot mode.

Manufacturing sequence

1. Format or prepare the drive.
2. Copy this runtime kit to the drive root.
3. Run factory/powershell/Prepare-WindowsPortableDrive.ps1 on a connected factory PC.
4. Download or copy backends into backends/*.
5. Pull/preload LLM models into models/ollama and/or models/gguf.
6. Build JackAILocald Rust binaries for Windows and Linux.
7. Apply branding.
8. Generate manifest and hashes.
9. Run QA benchmark.
10. Ship.

Customer sequence

Windows path:

1. Insert drive.
2. Open drive.
3. Double-click START-HERE.cmd.
4. JackAILocal starts the local backend and opens the UI.

Linux path:

1. Insert drive.
2. Reboot computer.
3. Choose USB from boot menu.
4. Linux starts JackAILocal in kiosk mode.

Model policy

Models must be on the drive before shipment. The user should never be forced to download a model at first run. Optional extra models can be downloaded later if the user deliberately uses model management while online.