| # 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. | |