Skip to content
BOM AI logoBOM AI
XM
XM

BOM AI Manual

Install on macOS

Install BOM AI on your Mac with the verified install script — the chat opens at port 8080.

Install BOM AI on macOS

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

Testing status: the macOS package declares support for macOS 12 and later (both Apple Silicon and Intel x64), but it has not yet completed full clean-machine testing. If something goes wrong, please report the symptom and your machine details on the FAQ page.

Requirements

Item Requirement
Operating system macOS 12 or later (arm64 or x64)
Python 3.11 or 3.12
RAM 8 GB minimum / 16 GB recommended
Internet required for the first download

The shared model plus image reader is about 3.4 GB; the total download depends on whether Ollama is already on the machine.

1. Download the script and verify the hash

Download install-bom-ai-mac.sh from the BOM AI download page and verify it before running:

  • File size: 13,059 bytes
  • SHA-256: 80e4c4b37de4f4fa8774aab748f7a5c74daf75a037f8dd57ea2a4c46a0df69a5
shasum -a 256 install-bom-ai-mac.sh

2. Run the installer

Open Terminal, go to the folder with the script, and run:

bash install-bom-ai-mac.sh
  • The script installs under $HOME/BOM-AI, in your current user's home folder.
  • If Homebrew is present the script uses the Homebrew-managed path; otherwise follow the steps the script shows.
  • Some steps may ask for extra privileges — read each prompt fully before confirming.
  • The script prepares the Python environment (venv) and installs the Open WebUI 0.12.5 chat page.

Wait for the model download to finish and do not run two installer windows at once.

3. Open your first chat

When the install completes, open http://127.0.0.1:8080 in Safari or your usual browser.

On first launch, create the local account exactly as shown on screen — it belongs to the chat page on your machine only, not to any BOM AI subscription.

On macOS, web search is off by default. Normal chatting works without it.

4. Try your first chat

Type "Help me draft a short quotation email" and send. When the answer arrives, reload the page and reopen the same conversation to check the history is still there.

Ready → continue to Usage & Model Selection.

Stuck?

Start with the FAQ launch fixes and note your chip, macOS version, script version, and the exact message you see.

Update, uninstall, and backups

Chatting without web search works offline once the download completes; searching current information still needs the internet.

Before updating or uninstalling, back up the conversations you want to keep, then follow the instructions shipped with that version of the script. Deleting only the app folder may leave chat data or models behind — always read what the confirmation says will be removed.

XM
XM