BooleX.ai DOCS Book a demo
Docs / Guides

First cited answer in a day

From an unboxed edge PC to the first cited answer about the pilot line, in nine time-boxed steps.

The target is a first cited answer about the pilot line within one working day (7 h 45 min of time boxes). Before you start, the deployment guide is signed, the conduits are open and the read-only accounts exist: see Network and security and the checklist in Get started.

Step 0: the edge PC (30 min)

Linux with Docker Engine and Compose, the release package on removable media and the release public key at /config/release-key.pub. Check docker info.

Step 1: install (30 min)

shell
python -m settings.release install /media/usb/boolex-<version>

Step 2: site configuration (1 h)

Write site.yaml in the site folder, deploy/config/site/, from the configuration reference: endpoints, glossary, starter prompts, the KPI baseline and shifts, media retention and, for hybrid, the approved endpoints. Put tags.csv, alarms.csv, interlocks.csv, the code exports and the documents manifest beside it. Set customer_site: true. Every service reads the folder as /config/site, and its plant is the default plant.

shell
echo production > deploy/config/profile

Step 3: check the tag list (30 min)

shell
python -m ingest.validate_tags --url opc.tcp://<server>:4840

Fix every unmatched node ID before going on.

Step 4: accounts (15 min)

An administrator, the pilot technicians and one expert: see Add a user.

Step 5: import code, documents and work orders (1 h)

See Import code exports and Documents and work orders.

shell
python -m documents.load docs/manifest.yaml

Step 6: connect read-only (1 h)

Start the stack against the site endpoints and confirm values arrive and no platform alarm shows.

shell
make up PROFILES=
make logs

Step 7: local model (1 h)

shell
make up PROFILES=,ollama && make model

Step 8: smoke question (15 min)

Sign in as a technician, ask "Why did the line stop?" about the last stop, and open three citations.

Step 9: evaluation gate and week-0 assessment (1 h)

Score the site's past stops and record the baseline: see Run the week-0 assessment.