kplot

Web-based visualization for kinfer-log robot telemetry data. DATA DATA DATA DATA!!!!

Server Setup (Production)

Deploy server with systemd:

git clone https://github.com/kscalelabs/kplot.git ~/kplot
cd ~/kplot
./scripts/deploy.sh

Server runs at http://your-server:5001

Updates:

cd ~/kplot && git pull && ./scripts/deploy.sh

Logs:

sudo journalctl -u kplot.service -f

Local Development

cd ~/kplot
pip install -e .
kplot-server --data-dir ~/robot_telemetry --port 5001

Open: http://localhost:5001

Pages

• / - Main viewer with source selection sidebar
• /latest - Auto-updating view of the most recent run (refreshes every 2 seconds)

Data Format

~/robot_telemetry/
├── kd-1/
│   └── session_20251013_110106/
│       └── kinfer_log.ndjson
├── kd-8/
│   └── session_20251013_120000/
│       └── kinfer_log.ndjson

NDJSON records:

{
  "step_id": 0,
  "timestamp": 1760378501.967,
  "joint_angles": [...],
  "joint_velocities": [...],
  "joint_order": ["dof_left_hip_pitch_04", ...]
}