Troubleshooting

warning

Troubleshooting

Start here

powershell

botconnector doctor
botconnector doctor --json

Include this output when reporting any issue — see botconnector doctor.

Guides

Problem area	Guide
Download fails / slow / corrupted	Download problems
Runtime won't start / crashes	Runtime problems
Out of memory at load	Memory problems
GPU backend errors	GPU problems
API unreachable / errors	API problems
Wrong output / template issues	Model problems

General diagnostic order

botconnector doctor — environment facts first.
botconnector runtime status — is the runtime READY?
botconnector ps — is a model loaded?
curl http://127.0.0.1:11435/v1/models — does the API respond?
Read the specific guide for your symptom above.

Collecting evidence

Log files: %USERPROFILE%\botconnector\logs.
Runtime stderr is preserved per launch (Runtime troubleshooting).
--json outputs from CLI commands are stable for bug reports (Automation).