Balaur is terminal-first now. There is no core HTTP gateway and no balaur-agent user service.
The live path is:
balaur terminal → Pi package/extensions/skills/theme → local model llama-apu (:8082)
cd ~/balaur
make doctor
Doctor checks tooling, dependencies, tests, local model, and Pi terminal config.
balaur command not foundcd ~/balaur
make install-cli
Or run directly:
bash ~/balaur/bin/balaur
Symptoms: no Balaur theme/UI, memory tools missing, /skill:doctor missing.
cd ~/balaur
bash scripts/seed-pi-config.sh
cat ~/.pi/agent/settings.json
Confirm packages contains:
"/home/cico/balaur/pi"
Then run /reload in the terminal.
Check:
curl -s http://127.0.0.1:8082/health
If refused/down, the operator should inspect the system unit:
sudo systemctl status llama-apu --no-pager
sudo journalctl -u llama-apu -n 80 --no-pager
First start may download the GGUF and take time. Re-tune/reinstall local model wiring:
bash scripts/setup-local-llm.sh
That means this Pi session was manually switched. Check or switch with:
/model
Choose llama-apu / qwen_qwen3.6-35b-a3b for local/private. Frontier use is opt-in.
cd ~/balaur
bun test
bash scripts/seed-pi-config.sh
Then run /reload in the terminal. For dependency changes:
cd ~/balaur/pi
bun install
Set a fine-grained PAT in .env:
BALAUR_GITHUB_TOKEN=github_pat_xxx
Then re-run:
bash scripts/seed-pi-config.sh
The repo no longer ships it. Stop stale host state once:
systemctl --user disable --now balaur-agent
rm -f ~/.config/systemd/user/balaur-agent.service
systemctl --user daemon-reload
No sudo needed; this is a user unit.
| Task | Command |
|---|---|
| health check | make doctor |
| open terminal | balaur |
| reload Pi resources | /reload inside terminal |
| local model health | curl -s http://127.0.0.1:8082/health |
| local model logs | sudo journalctl -u llama-apu -f |
| rebuild memory index | make index |
| run tests | bun test |