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.1-py3-none-any.whl (32.9 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: dexmate_urdf-0.8.1-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.7

File hashes

Hashes for dexmate_urdf-0.8.1-py3-none-any.whl
Algorithm Hash digest
SHA256 aa3922aaa91bb5fa5b85d50c495e2a55aa2284cdec2ab60cc92208cd56c68c96
MD5 b0f8ed63803d50436e32180bda87d690
BLAKE2b-256 25740de8092e02c2072cf38b2095c1f45ab1e0ad0a77c733e92ad02402789782

See more details on using hashes here.

Provenance

The following attestation bundles were made for dexmate_urdf-0.8.1-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