Settings & Integrations
Polyborg OS is API-ready and robot-controller-ready. Every workflow becomes a reusable recipe. Every detection becomes a training example.
System Architecture
Camera frame
upload / live
Supabase Edge Function
run-roboflow-inference
Roboflow Hosted API
protected key
Detection JSON
normalized
perception_events
postgres
robot_commands
queued
Dashboard update
realtime
The Roboflow API key never reaches the browser — every inference call is proxied through the run-roboflow-inference edge function.
Supabase Edge Function
Function
run-roboflow-inference
Writes to perception_events + robot_commands
Last run
—
API key exposure: Protected (server-side only)
Sample request
{
"image_url": "https://example.com/case-image.jpg",
"line_id": "line_1",
"workflow_id": "workflow_deodorant_palletizing",
"confidence_threshold": 0.85
}Sample perception_event
{
"event_type": "object_detection",
"object_class": "case",
"confidence": 0.984,
"x": 412,
"y": 238,
"width": 180,
"height": 90,
"rotation": 12,
"pickability": "high"
}Roboflow Hosted API
Add Roboflow credentials as secrets on the edge function. While missing, Polyborg OS runs in demo mode with realistic simulated detections.
85%
API key status
Missing — using simulated mode
Last inference
—
Last detection count
—
Data Model
Tables backing the Polyborg OS demo. All tables are live in the backend.
facilities
Customer manufacturing sites.
idnamelocationstatus
production_lines
Lines inside each facility.
idfacility_idnameproductworkflow_typestatusthroughput_units_per_mincase_rate_per_minuptimeactive_sku
skus
Packaging recipes.
idfacility_idnameproduct_formatpackaging_surfacecase_lengthcase_widthcase_heightcase_weightunits_per_casecases_per_palletstack_height
workflows
Deployed line configurations.
idline_idworkflow_typesku_idpallet_patterngripper_typetarget_case_ratedeployment_status
perception_events
Every detection from Roboflow.
line_idworkflow_idevent_typeobject_classconfidencexyzwidthheightrotationpickabilityraw_json
robot_commands
Commands sent to the robot cell.
line_idworkflow_idcommand_typecommand_statuscommand_payload
deployment_logs
Auditable line activity.
facility_idline_idseverityevent_typemessagestatus
alerts
Operator alerts and exceptions.
facility_idline_idseverityalert_typemessagestatus
maintenance_events
Service & changeover history.
facility_idline_idevent_typedescriptionstatus
Robot Controller Integration
Commands written to robot_commands are consumable by:
KUKA controllerPLCROS2MQTTOPC-UAVendor robot cell API
Alerts
Missed pick threshold3 per hour
Low confidence detection85 %
Downtime alert5 minutes
Pallet misalignment alert
Notify if pallet guide drift exceeds tolerance
Low air pressure alert
Notify on vacuum gripper pressure drop