Skip to main content

URDF model and tools for Dexmate robots

Project description

๐Ÿค– Dexmate URDF Collection

High-quality Robot Models for Simulation and Planning

Models Python License

๐ŸŽฏ Overview

This repository contains high-fidelity robot models in Unified Robot Description Format (URDF) and Semantic Robot Description Format (SRDF). These models are essential for:

  • ๐ŸŽฎ Robot Simulation
  • ๐Ÿ”„ Motion Planning
  • ๐ŸŽจ Visualization
  • ๐Ÿ› ๏ธ Control System Development

The corresponding USD files are be found in the Release.

๐Ÿ“ฆ Installation

pip install dexmate_urdf

or install from source

cp -r robots/* src/dexmate_urdf/robots/
python scripts/workflows/generate_content.py
pip install -e .

๐Ÿš€ Quick Start

from dexmate_urdf import robots

# Access different robot models and configurations
# Base variants
vega_1_urdf = robots.humanoid.vega_1.vega_1.urdf
vega_1u_urdf = robots.humanoid.vega_1u.vega_1u.urdf
vega_1p_urdf = robots.humanoid.vega_1p.vega_1p.urdf

# Variants with different end-effectors
vega_1_f5d6_urdf = robots.humanoid.vega_1.vega_1_f5d6.urdf
vega_1_gripper_urdf = robots.humanoid.vega_1.vega_1_gripper.urdf
vega_1u_f5d6_urdf = robots.humanoid.vega_1u.vega_1u_f5d6.urdf

# Access SRDF and collision URDFs
vega_1_srdf = robots.humanoid.vega_1.vega_1.srdf
vega_1_collision = robots.humanoid.vega_1.vega_1.collision_spheres_urdf

# Load into your favorite simulator
load_robot(vega_1_f5d6_urdf)

๐Ÿค– Available Models

Robot Visual[^1] Convex Collision[^2] Sphere Collision[^3]
Vega-1

[^1]: High quality visual modeling for rendering. [^2]: Collision modeling composed of convex decomposition meshes with light simplification, which can be used for physical simulation, etc. [^3]: Collision modeling composed of spheres, which can be an alternative collision representation when speed is more of a concern. These meshes are larger than the real one, which is not desirable to be used in high-fidelity simulation.

๐Ÿ”ง Supported Platforms

Our models are tested with popular robotics frameworks:

  • ๐ŸŽฎ IsaacSim/IsaacLab/IsaacGym - For simulation and RL training
  • ๐Ÿ”„ Pinocchio - For kinematics and dynamics computation
  • ๐ŸŽฏ SAPIEN - For simulation and visualization

๐Ÿ“š Package Structure

dexmate_urdf.robots
โ”œโ”€โ”€ humanoid/
โ”‚   โ”œโ”€โ”€ vega_1/                  # Base variant folder
โ”‚   โ”‚   โ”œโ”€โ”€ vega_1.urdf          # Base variant (no hands)
โ”‚   โ”‚   โ”œโ”€โ”€ vega_1_f5d6.urdf     # With F5D6 hands
โ”‚   โ”‚   โ”œโ”€โ”€ vega_1_gripper.urdf  # With gripper hands
โ”‚   โ”‚   โ”œโ”€โ”€ vega.urdf            # Alias (symlink to vega_1_f5d6)
โ”‚   โ”‚   โ””โ”€โ”€ configs/             # Variant-specific configs
โ”‚   โ”œโ”€โ”€ vega_1u/                  # Upper body variants
โ”‚   โ”‚   โ”œโ”€โ”€ vega_1u.urdf
โ”‚   โ”‚   โ”œโ”€โ”€ vega_1u_f5d6.urdf
โ”‚   โ”‚   โ””โ”€โ”€ vega_1u_gripper.urdf
โ”‚   โ””โ”€โ”€ vega_1p/                  # Pro variants
โ”‚       โ”œโ”€โ”€ vega_1p.urdf
โ”‚       โ”œโ”€โ”€ vega_1p_f5d6.urdf
โ”‚       โ””โ”€โ”€ vega_1p_gripper.urdf
โ””โ”€โ”€ ... # More robots

๐Ÿ“ Changelog

For information about recent updates and changes, please refer to the CHANGELOG.md.

๐Ÿ“„ Licensing

๐Ÿ”“ Apache License 2.0

This software is licensed under the Apache License 2.0. This permissive license allows you to:

  • โœ… Use the software commercially
  • โœ… Modify the software and create derivatives
  • โœ… Distribute copies and modifications
  • โœ… Use patent claims (if applicable)

See the LICENSE file for the complete license text.


๐Ÿค Need help with robot models?

๐ŸŒ Visit Website โ€ข ๐Ÿ“ง Contact Us โ€ข ๐Ÿ“š View Robots

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

dexmate_urdf-0.8.3-py3-none-any.whl (32.9 MB view details)

Uploaded Python 3

File details

Details for the file dexmate_urdf-0.8.3-py3-none-any.whl.

File metadata

  • Download URL: dexmate_urdf-0.8.3-py3-none-any.whl
  • Upload date:
  • Size: 32.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dexmate_urdf-0.8.3-py3-none-any.whl
Algorithm Hash digest
SHA256 54f03a7ae436dae8f65d2a5a3ba81dee917447cb23560892fcf0593496239b52
MD5 60ab0c4da261ec63db48bf9f32a8e402
BLAKE2b-256 c2dabb7cc26e23ea7e557f43c6f406ff5e27d89f0a92cdd1f8d7ab896503c39e

See more details on using hashes here.

Provenance

The following attestation bundles were made for dexmate_urdf-0.8.3-py3-none-any.whl:

Publisher: pypi.yml on dexmate-ai/dexmate-urdf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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