Skip to main content

Full-featured ROSClaw Dashboard — Next.js frontend + FastAPI backend

Project description

ROSClaw Dashboard

e-URDF-native Physical AI Control Plane — unifying robot embodiment, live telemetry, MCAP replay, agent missions, skill execution, memory inspection, and simulation feedback.

Architecture

rosclaw-dashboard/
├── apps/
│   ├── api/              FastAPI backend (SQLite + DuckDB)
│   ├── web/              Next.js dashboard frontend
│   └── robot-daemon/     WebSocket bridge for robot telemetry
├── packages/
│   ├── eurdf-schema/      TypeScript interfaces for e-URDF
│   ├── eurdf-parser/      YAML parser + Zod validator + CLI
│   ├── mcap-indexer/      MCAP file indexing
│   ├── foxglove-layout-generator/  Foxglove layout generator
│   ├── robot-viewer/      3D robot viewer (Three.js)
│   ├── timeline-core/     Unified timeline engine
│   └── sdk/               Client SDK
├── robots/
│   ├── unitree_go2/       Unitree Go2 sample config
│   ├── ur5e/              UR5e sample config
│   └── turtlebot4/        TurtleBot4 sample config
└── docs/                  Documentation

Quick Start

Prerequisites

  • Node.js >= 22
  • pnpm (corepack enable)
  • Python >= 3.11

Install

pnpm install
cd apps/api && python -m venv .venv && source .venv/bin/activate && pip install -e ".[dev]"

Run Backend

cd apps/api
source .venv/bin/activate
uvicorn src.main:app --reload --port 8000

# Seed sample robots
python scripts/seed.py

Run Frontend

cd apps/web
pnpm dev

Visit http://localhost:3000

Run Robot Daemon

cd apps/robot-daemon
pnpm build
ROBOT_ID=go2_lab_001 pnpm start

V0.1 MVP Features

Feature Status
e-URDF Schema & Parser Done
Robot Registry Done
Embodiment Explorer Done
MCAP Import / Index Done
Foxglove Layout Generator Done
Mission Board Done
Agent Execution Trace Done
Unified Timeline (stub) Done
Safety Center Done
Memory Inspector Done

Dashboard Pages

  1. Robot Registry — Register and manage robots
  2. Embodiment Explorer — Browse sensors, actuators, skills
  3. Live Robot Console — Real-time telemetry (via robot-daemon)
  4. Agent Mission Control — Mission board with pause/resume/abort
  5. MCAP Replay & Review — MCAP file management and Foxglove integration
  6. Skill & Capability Matrix — Skill readiness per robot
  7. Memory Inspector — rosclaw-memory integration (future)
  8. Safety & Approval Center — Emergency stop, speed limits, approvals

API Endpoints

GET  /health
GET  /api/robots
POST /api/robots
POST /api/robots/import
GET  /api/robots/{id}
GET  /api/robots/{id}/embodiment
GET  /api/robots/{id}/sensors
GET  /api/robots/{id}/actuators
GET  /api/robots/{id}/skills
GET  /api/missions
POST /api/missions
GET  /api/missions/{id}
GET  /api/missions/{id}/trace
POST /api/missions/{id}/pause
POST /api/missions/{id}/resume
POST /api/missions/{id}/abort
GET  /api/mcap
POST /api/mcap/import
GET  /api/mcap/{id}/foxglove-layout
GET  /api/memory
GET  /api/memory/stats/summary
GET  /api/safety/audits
GET  /api/safety/rules
POST /api/safety/rules/{id}/toggle

e-URDF Format

Robots are described by YAML sidecars alongside URDF:

robots/{robot_id}/
  robot.eurdf.yaml    # Body model, sensors, actuators, frames
  robot.skills.yaml   # Skill definitions and requirements
  robot.safety.yaml   # Safety limits and approval rules

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rosclaw_dashboard-1.0.0.tar.gz (433.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rosclaw_dashboard-1.0.0-py3-none-any.whl (562.0 kB view details)

Uploaded Python 3

File details

Details for the file rosclaw_dashboard-1.0.0.tar.gz.

File metadata

  • Download URL: rosclaw_dashboard-1.0.0.tar.gz
  • Upload date:
  • Size: 433.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for rosclaw_dashboard-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ba5bc3f68bf07f28758822e2ff54612037bec7058e230b1d1a95c76a94669caf
MD5 67ff063ba86eff5a6a1924d9dc80ec9d
BLAKE2b-256 98c531027b1e7d96e876f29c939e68be7b63f49757b2fc1d591bc823d07f45f3

See more details on using hashes here.

File details

Details for the file rosclaw_dashboard-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for rosclaw_dashboard-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 57a9d3a744221954f27ee3485f05bff0b8afad93dd1d860dea2952f52a131bed
MD5 a2ce7da90a90cd5e9cb8dce487dad52c
BLAKE2b-256 09fe683f5615beb69b438dffdd1b7533206cf53ad71edc454601e800f272ec26

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page