Health Checks
Automated checks that verify your Hamster AI installation is working correctly.
Run health checks any time with /health in chat, or from the Diagnostics window. Each check returns a pass, warning, or fail status with a brief explanation.
Checks Performed
| Check | What it verifies | Common failure reason |
|---|---|---|
| Ollama running | Ollama is reachable at the configured URL | Ollama not started — run ollama serve |
| Model installed | The selected model is available in Ollama | Model not pulled — run ollama pull <model> |
| Database accessible | SQLite database can be read and written | Database file locked or corrupt — check data/hamster_ai.db |
| Plugin load failures | All enabled plugins loaded without errors | Missing optional dependency — see plugin details |
| Config files valid | JSON config files are parseable | Manual edit introduced a syntax error |
| Data folder writable | The data/ directory can be written to |
Permissions issue or drive full |
| Disk space | At least 500 MB free on the drive | Drive nearly full |
| Startup registration | If "Start with Windows" is on, the registry entry is valid | Python path changed after enabling startup |
Check Results
| Status | Meaning |
|---|---|
| ✅ Pass | Everything looks good |
| ⚠️ Warning | Something is off but the app can still run |
| ❌ Fail | A critical component is broken — action required |
Running on Startup
A subset of health checks runs automatically when Hamster AI starts. Any failures are logged and shown in the Diagnostics window. Critical failures (e.g. Ollama not running) show a tray notification.