Skip to content
BOM AI logoBOM AI
XM
XM

BOM AI Manual

Install on Windows

Download the ZIP, verify the hash, install per-user, and open your first chat — about 10 minutes.

Install BOM AI on Windows

This manual is for BOM AI v0.3.1-r2.

Requirements

Item Requirement
Operating system Windows 10 version 22H2 or later, or Windows 11 (x64)
RAM 8 GB minimum / 16 GB recommended
Free disk space about 30 GB
Internet required for the first download

If Ollama is not installed yet, the installer downloads about 5.1 GB in total; the shared model plus image reader is about 3.4 GB.

1. Download and verify the ZIP

Open the BOM AI download page and get bomai-windows-installer-r2.zip. Verify it against the published values before extracting:

  • File size: 1,247,724,605 bytes (about 1.25 GB)
  • SHA-256: cbd645ea04db97e23d80f3caf2d5429273a7c42e6c0559c6b2d2ea40576fff73
Get-FileHash .\bomai-windows-installer-r2.zip -Algorithm SHA256

2. Extract the full package

Extract the ZIP into one folder. You must see Install-BOM-AI.bat and the payload/ folder side by side — never copy the BAT file alone, the installer needs the payload data.

3. SmartScreen warning

When you run the BAT file, SmartScreen may say Windows does not know this file. Confirm the file came from the BOM AI download page and the hash matches, then click More info → Run anyway.

Do not disable your antivirus. If you ever see a "threat found" message, stop and check the file with the developer first — that is not the same kind of warning as SmartScreen.

4. Install location and options

  • The default install location is %LOCALAPPDATA%\BOMAI — a per-user install for your current Windows account. If you choose another location, use a local NTFS drive with enough free space.
  • The web search component (SearXNG) is selected by default and web search is enabled on Windows by default. Behavior when you deselect this component is still being verified.
  • Tailscale is optional and off by default; installing it requires an administrator (UAC) prompt.

5. Wait for the install and model download

Start the installer and wait for the model download to finish. Do not launch a second installer window while one is running. If your connection drops, reconnect and follow the message shown by the installer.

6. Open your first chat

Open BOM AI from the shortcut it created. The chat page opens at http://127.0.0.1:8080.

On first launch, create the local account exactly as shown on screen and keep a note of it. This account belongs to the chat page on your machine only — it is not a BOM AI subscription.

7. Try your first chat

  1. In the model picker, use BOM AI Safe, the setup prepared by the installer
  2. Type "Introduce yourself briefly" and send
  3. When the answer arrives, follow up with "Help me draft a 3-line vacation leave email"
  4. Reload the page and reopen the same conversation to check the history is still there

Ready → continue to Usage & Model Selection.

Won't open or the download never finishes?

Start with the FAQ launch fixes and note the exact message you see. Do not delete the %LOCALAPPDATA%\BOMAI folder to fix a problem — you would lose your chat history and the downloaded model.

Update and uninstall

Before updating, read the notes for the new version on the download page, back up conversations you want to keep, and close BOM AI before using the update method specified for the package.

Uninstall from Settings → Apps → Installed apps: select the BOM AI entry and use its uninstall command. Read what the confirmation dialog says about chat data and models — deleted data may not be recoverable.

XM
XM