Operating Guaardvark
B=${GUAARDVARK_URL:-http://localhost:5000}. MCP tools: inspect_gpu, read_logs, swarm_status, self_improvement_status.
GPU and plugins
inspect_gpu (MCP): nvidia-smi, the exclusive lock (Ollama vs video), orchestrator slots, running plugins.GET $B/api/plugins/status and GET $B/api/plugins/<id>/health; GET $B/api/plugins/stats/gpu.POST $B/api/plugins/<id>/start | stop | restart | enable | disable for ollama, comfyui,
audio_foundry, upscaling, lora_trainer, swarm, vision_pipeline, discord,
gpu_embedding, video_editor. Start services through these routes, never with systemctl;
the orchestrator must know what is resident.GET $B/api/plugins/<id>/logs?lines=200 for a plugin's own log.- Memory orchestrator:
GET $B/api/gpu/memory/status, GET/POST $B/api/gpu/memory/tier.
POST .../evict {"slot_id"} frees a slot; use only when the user asks to clear the card.
Logs and tasks
read_logs (MCP) tails a file under logs/ (backend, celery, plugin logs).GET $B/api/celery/tasks shows active Celery tasks; GET $B/api/meta/... job routes list and
retry jobs (POST $B/api/meta/retry_job/<job_id>, POST $B/api/meta/cancel_job/<job_id>).- A "stuck" job is usually the GPU lock held by another plugin: check
inspect_gpu before retrying.
Interconnector (other machines sync from this one)
GET $B/api/interconnector/status, GET .../nodes, GET .../sync/history?limit=20.POST $B/api/interconnector/sync/manual with {"direction": "push", "entities": [...], "sync_files": true, "profile_name": "..."}; POST .../nodes/<node_id>/test checks a link.- Other boxes never
git pull; they sync through this. A frontend change needs a bundle rebuild
there afterwards.
Autoresearch (overnight RAG tuning)
POST $B/api/autoresearch/start {"mode": "...", "budget_hours": 6}; GET .../status,
GET .../runs, GET .../runs/<run_id>/ledger; POST .../stop. Promotions of a better config are
explicit: POST .../promotions/<config_id>/activate, POST .../promotions/revert.
Infographic
curl -s -X POST $B/api/infographic/generate -H 'Content-Type: application/json' -d '{
"title": "Three numbers", "scene": "clean flat design, navy and white",
"callouts": ["42% faster", "0 cloud calls", "1 GPU"], "hashtags": ["#localai"], "footer": "guaardvark.com",
"style": "flat", "aspect": "1:1", "seed": 3
}'
GET $B/api/infographic/status for the job; the image lands in outputs.
Rules
- Restarting a plugin kills its jobs. Check the queues and say so before restarting.
- Never restart the backend or Celery from here; tell the user what to run in the checkout.
1---2name: ops3description: Operate a running Guaardvark: GPU and VRAM state, plugin start/stop, logs, Celery tasks, the Interconnector sync to other machines, overnight RAG autoresearch, and infographics. Use when the user asks what is using the GPU, why a job is stuck, to start or stop ComfyUI/Audio Foundry/Swarm, to sync another box, to run autoresearch, or to make an infographic.4---56# Operating Guaardvark78`B=${GUAARDVARK_URL:-http://localhost:5000}`. MCP tools: `inspect_gpu`, `read_logs`, `swarm_status`, `self_improvement_status`.910## GPU and plugins1112- `inspect_gpu` (MCP): nvidia-smi, the exclusive lock (Ollama vs video), orchestrator slots, running plugins.13- `GET $B/api/plugins/status` and `GET $B/api/plugins/<id>/health`; `GET $B/api/plugins/stats/gpu`.14- `POST $B/api/plugins/<id>/start | stop | restart | enable | disable` for `ollama`, `comfyui`,15 `audio_foundry`, `upscaling`, `lora_trainer`, `swarm`, `vision_pipeline`, `discord`,16 `gpu_embedding`, `video_editor`. Start services through these routes, never with systemctl;17 the orchestrator must know what is resident.18- `GET $B/api/plugins/<id>/logs?lines=200` for a plugin's own log.19- Memory orchestrator: `GET $B/api/gpu/memory/status`, `GET/POST $B/api/gpu/memory/tier`.20 `POST .../evict {"slot_id"}` frees a slot; use only when the user asks to clear the card.2122## Logs and tasks2324- `read_logs` (MCP) tails a file under `logs/` (backend, celery, plugin logs).25- `GET $B/api/celery/tasks` shows active Celery tasks; `GET $B/api/meta/...` job routes list and26 retry jobs (`POST $B/api/meta/retry_job/<job_id>`, `POST $B/api/meta/cancel_job/<job_id>`).27- A "stuck" job is usually the GPU lock held by another plugin: check `inspect_gpu` before retrying.2829## Interconnector (other machines sync from this one)3031- `GET $B/api/interconnector/status`, `GET .../nodes`, `GET .../sync/history?limit=20`.32- `POST $B/api/interconnector/sync/manual` with `{"direction": "push", "entities": [...],33 "sync_files": true, "profile_name": "..."}`; `POST .../nodes/<node_id>/test` checks a link.34- Other boxes never `git pull`; they sync through this. A frontend change needs a bundle rebuild35 there afterwards.3637## Autoresearch (overnight RAG tuning)3839`POST $B/api/autoresearch/start {"mode": "...", "budget_hours": 6}`; `GET .../status`,40`GET .../runs`, `GET .../runs/<run_id>/ledger`; `POST .../stop`. Promotions of a better config are41explicit: `POST .../promotions/<config_id>/activate`, `POST .../promotions/revert`.4243## Infographic4445```bash46curl -s -X POST $B/api/infographic/generate -H 'Content-Type: application/json' -d '{47 "title": "Three numbers", "scene": "clean flat design, navy and white",48 "callouts": ["42% faster", "0 cloud calls", "1 GPU"], "hashtags": ["#localai"], "footer": "guaardvark.com",49 "style": "flat", "aspect": "1:1", "seed": 350}'51```52`GET $B/api/infographic/status` for the job; the image lands in outputs.5354## Rules5556- Restarting a plugin kills its jobs. Check the queues and say so before restarting.57- Never restart the backend or Celery from here; tell the user what to run in the checkout.
guaardvark