URDF-Studio  by OpenLegged

Visual robot modeling and assembly workstation

Created 4 months ago
283 stars

Top 92.1% on SourcePulse

GitHubView on GitHub
Project Summary

Professional robot design, assembly, visualization, and export workstation for URDF, MJCF, USD, Xacro, SDF, and .usp project workflows. URDF Studio is a browser-based environment that streamlines robot modeling by offering a visual interface for topology, geometry, and hardware parameters, reducing the need for manual XML editing. It targets engineers and researchers requiring a robust tool for complex robot description management.

How It Works

Built with React, TypeScript, and Three.js, URDF Studio employs a visual, component-driven architecture. It features structured editing modes (Skeleton, Detail, Hardware) within a unified 3D workspace powered by React Three Fiber. Core advantages include multi-robot assembly with bridge joints, robust workspace file management, and workerized pipelines for efficient import/export of formats like USD, MJCF, and URDF, alongside AI-assisted generation capabilities.

Quick Start & Requirements

  • Installation: Clone the repository (git clone https://github.com/OpenLegged/URDF-Studio.git), navigate into the directory (cd URDF-Studio), and install dependencies (npm install).
  • Prerequisites: Node.js 18+ and npm are required. A modern Chromium-based browser is recommended for local validation.
  • Running: Execute npm run dev to start the Vite development server, accessible at http://127.0.0.1:3000.
  • Environment Variables: Optional variables like OPENAI_API_KEY can be set in .env.local to enable AI features.
  • USD Runtime: Requires a cross-origin isolated environment, automatically configured by npm run dev and npm run preview.
  • Live Demo: Available at https://urdf.d-robotics.cc/.

Highlighted Details

  • Supports a wide array of robot description formats including URDF, MJCF, USD, Xacro, and SDF.
  • Features AI-assisted robot model generation, inspection, and report export.
  • Includes a reusable @urdf-studio/react-robot-canvas package for integrating robot visualization into external React applications.
  • Enables multi-robot assembly within a single workspace using bridge joints.
  • Provides robust USD runtime hydration, export caches, and roundtrip archive workflows.

Maintenance & Community

The project is supported by D-Robotics. No specific community channels (like Discord/Slack) or detailed contributor information are listed in the README.

Licensing & Compatibility

Licensed under the Apache License 2.0, this project is permissive for commercial use and integration into closed-source applications.

Limitations & Caveats

The USD runtime necessitates specific cross-origin isolation headers, which might require careful server configuration beyond basic static file serving. AI features are optional and depend on external API key provisioning. Ongoing updates to test fixtures are noted.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
13
Issues (30d)
3
Star History
56 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.