How dzaczek/phoneborg works
PhoneBorg turns USB-connected Android phones—and optionally desktop inference engines—into a managed inference cluster behind compatible APIs. The main path provisions phones, has agents report inventory and health, plans model placement, and routes client requests with affinity and failover. The graph also preserves management, model catalog, external engines, usage, and observability capabilities. Source excerpts are partial; README statements support the product-level flows, while source-index references support only the listed module relationships.
Main entry points: proxy.go OpenAI gateway · server.go Controller HTTP server · agent.go Phone agent · provision.go ADB provisioning
Components 29
Provisioning and agents
- ADB provisioning
provisioner/provision.go - Phone agent
node-agent/agent.go - Device inventory
node-agent/inventory.go - Model manager
node-agent/manager.go - Inference runtime
node-agent/runtime.go
Controller and placement
- Controller HTTP server
controller/server.go - Node registry
controller/registry.go - Model catalog
controller/models/catalog.go - Placement planner
controller/models/planner.go - Placement control
controller/placement.go - Node pools
controller/pools.go - Wire protocol
proto/v0.go - Memory sizing
internal/memplan/memplan.go
Inference gateway
- OpenAI gateway
controller/gateway/proxy.go - Target selection
controller/gateway/picker.go - Gateway auth
controller/gateway/auth.go - External node integration
controller/external.go
Management surfaces
- Admin API
controller/admin.go - pbctl CLI
controller/cmd/pbctl/main.go - Web panel views
controller/ui/static/js/views - Panel API client
controller/ui/static/js/api.js - OpenCode bridge
controller/cmd/pbctl/opencode.go
Usage and observability
- Usage accounting
controller/usage.go - Prometheus metrics
controller/server.go
Other components
- Inference clients
- Operators
- Android phones
- External engines
- Prometheus and Grafana
Connections 27
- Android phones → ADB provisioning: connects by USB
- ADB provisioning → Phone agent: installs and starts
- Phone agent → Controller HTTP server: reports health
- Phone agent → Device inventory: collects device data
- Phone agent → Model manager: reconciles desired model
node-agent/manager.go - Model manager → Inference runtime: loads model into
node-agent/manager.go - Controller HTTP server → Node registry: tracks nodes
- Controller HTTP server → Model catalog: serves catalog
controller/server.go - Model catalog → Placement planner: triggers replanning
- Placement planner → Memory sizing: uses sizing
controller/models/planner.go - Controller HTTP server → OpenAI gateway: registers routes
controller/server.go - OpenAI gateway → Gateway auth: authenticates requests
- OpenAI gateway → Target selection: selects target
- OpenAI gateway → Node registry: routes to phones
- OpenAI gateway → Node pools: supports pool targets
- OpenAI gateway → External node integration: routes external nodes
- External engines → External node integration: registers as node
- Operators → pbctl CLI: manages cluster
- pbctl CLI → Admin API: calls admin API
controller/cmd/pbctl/main.go - Operators → Web panel views: uses panel
- Web panel views → Panel API client: requests data through
controller/ui/static/js/app.js - Panel API client → Admin API: calls admin endpoints
controller/ui/static/js/api.js - Inference clients → OpenAI gateway: sends inference requests
- Operators → OpenCode bridge: configures subagents
- Controller HTTP server → Usage accounting: accounts usage
- Controller HTTP server → Prometheus metrics: exports metrics
controller/server.go - Prometheus metrics → Prometheus and Grafana: scraped by