Get your workspace running. | BrainBoxBrainBox. (https://brainbox.aisoft.us/site.html)Try the demo (https://brainbox.aisoft.us/knowledge.html)Get help (https://brainbox.aisoft.us/contact.html)
Setup guide
Get started (https://brainbox.aisoft.us/setup.html)Advanced setup (https://brainbox.aisoft.us/setup-advanced.html)Troubleshooting (https://brainbox.aisoft.us/setup-help.html)By AIsoft (https://aisoft.us/)
Get your workspace running.

Checks you can make before requesting help.



The app does not open

The public demo works at the demo workspace (https://brainbox.aisoft.us/knowledge.html). Your installed app opens at http://localhost:8630/app on the Mac where you installed it. On a phone, localhost means the phone, not your Mac.

Check that the installer completed its final step and that the Mac is awake. For an installed service, inspect:

tail -n 40 "$HOME/BrainBox/logs/brainbox.err"
tail -n 40 "$HOME/BrainBox/logs/brainbox.log"

A port-in-use error can mean another BrainBox instance is already running. Do not launch multiple instances against the same library.




No model or no answer

Open Local setup and check the runtime, installed model list, and processing policy. If you removed a previously selected model, choose another installed model or Automatic selection.

ollama list
curl -fsS http://localhost:8630/api/doctor

“Retrieval only” means the app can return sources but has no answer model available. An empty model response is reported as an error. Local answers can take time, particularly with large models or long source material; try a smaller installed model and a focused question.

Keep the local-only policy if you want all model processing on this machine. Adding a cloud key is not required to fix a local setup.




A file did not import

Read the message beside that file. Common causes:

PDF: the PDF reader is missing, or the file is scanned and has no extractable text. Scanned PDFs need OCR before import.

Audio: the transcription tool or model file is missing.

Image: the configured vision model is missing or unavailable.

Unsupported file: convert to a supported format while retaining the original.

Try one small file first. Importing is not a substitute for keeping your originals. Wait for imports to finish before restarting or backing up.




Search or the map looks empty

Search for an exact phrase from a successfully imported document. Semantic search depends on embeddings, which may still be processing. Open a known document to confirm that its text was extracted correctly.

Map lines represent explicit document links. BrainBox does not invent connections merely because two documents sound similar. A sparse map does not mean search is broken.




Feedback did not change the model

That is expected. Ratings and corrections are saved for review. The two built-in skills guide future answers, but feedback does not automatically retrain the model. Fine-tuning and automated task execution are not part of the current setup flow.




Still need a hand?

Send your operating system, machine model, memory, the step that failed, and the visible error. Do not send your library, private documents, or credentials. Diagnostic output can include local paths and model names; review it before sharing.

Help me set up ↗ (https://brainbox.aisoft.us/contact.html#lead-form)

Email hello@aisoft.us (mailto:hello@aisoft.us?subject=BrainBox%20setup%20help) or book a setup conversation (https://calendly.com/aisoft-llc/time-with-aisoft).

BrainBox. (https://brainbox.aisoft.us/site.html)By AIsoft (https://aisoft.us/)Setup (https://brainbox.aisoft.us/setup.html)Privacy (https://brainbox.aisoft.us/privacy.html)Terms (https://brainbox.aisoft.us/terms.html)Contact (https://brainbox.aisoft.us/contact.html)© 2026 AISOFT LLC.