Daemon API

The daemon listens on http://127.0.0.1:7473 by default. It is intentionally UI-neutral: the OpenTUI and non-interactive CLI both use this boundary.

Conventions

• JSON for request and response bodies unless noted.
• Server-Sent Events for container logs and long-running operation progress.
• RFC 3339 UTC timestamps.
• Opaque device, service, container, and operation IDs.
• Route methods are explicit; using the wrong method returns an error.

Health and fleet data

Method	Path	Purpose
GET	/health	Daemon readiness and version
GET	/devices	Device summaries and connection state
GET	/metrics	Aggregate fleet snapshot
GET	/metrics/{deviceID}	One device snapshot
POST	/reload	Reload local config and reconcile tunnels

Discovery and device lifecycle

Method	Path	Purpose
GET	/discovery/ssh-config-hosts	Parse and normalize ~/.ssh/config
GET	/discovery/tailscale/status	Local Tailscale install/login/running state
GET	/discovery/tailscale/peers	Peer inventory and tag normalization
POST	/bootstrap/device	Stream a new-device bootstrap operation
POST	/devices	Create a device record
PUT	/devices/{deviceID}	Update a device record
DELETE	/devices/{deviceID}	Remove device and associated local records
POST	/devices/{deviceID}/test	Test one configured device
POST	/devices/{deviceID}/upgrade	Upgrade one remote agent
POST	/devices/test-all	Test every device
POST	/devices/upgrade-all	Upgrade every remote agent

Deployment and service lifecycle

Method	Path	Purpose
GET	/deploy/bkc	Lookup exact, suggested, or device-aware BKC entries
POST	/deploy/vllm-memory-estimate	Run the hf-mem-backed vLLM estimate
POST	/deploy	Normalize and submit a workload deployment
POST	/containers/{deviceID}/{containerID}/stop	Stop a service
POST	/containers/{deviceID}/{containerID}/restart	Restart a service
DELETE	/containers/{deviceID}/{containerID}/remove	Remove a service
POST	/containers/{deviceID}/{containerID}/test	Probe a service endpoint
GET	/logs/{deviceID}/{containerID}	Stream logs over SSE
GET	/images/tags	List Docker image tags

Hugging Face

Method	Path	Purpose
GET	/hf/models?query=...&workload=...	Search up to 30 models; vLLM uses a text-generation filter
GET	/hf/gguf-variants?model=...	List GGUF files and quantization variants

Settings and integrations

Method	Path	Purpose
GET	/settings	HF status, preferences, history, and integration status
PATCH	/settings	Update theme or default images
PUT	/settings/hf-token	Save or clear the config token
POST	/settings/hf-token/validate	Validate a token with Hugging Face
GET	/history/deploy	Read recent models and images
PUT	/history/deploy	Replace normalized recent values
GET	/integrations/openai-endpoints	List running compatible endpoints
POST	/integrations/configure	Configure selected coding tools

Example

curl http://127.0.0.1:7473/health
curl http://127.0.0.1:7473/devices
curl 'http://127.0.0.1:7473/hf/models?query=qwen&workload=vllm'

The local daemon currently relies on loopback exposure as its trust boundary. Do not bind it to a shared interface without adding an appropriate authentication and transport layer.