onshape-robotics-toolkit 0.6.0

A python library to facilitate interaction with Onshape's REST API

onshape-robotics-toolkit

The onshape-robotics-toolkit is a feature-rich Python library that significantly extends the capabilities of Onshape's web-based CAD platform. The library provides a comprehensive API for automating robot design tasks, including solid model manipulation, robot assembly management, graph-based visualizations, and exporting CAD assemblies to URDF files for simulation and control. Intended as a resource for the robotics community, this library leverages Onshape's REST API to facilitate advanced workflows that bridge CAD design and robotics applications.

  This library was inspired by onshape-to-robot, a tool renowned for its streamlined approach to URDF generation. While onshape-to-robot library focuses on predefined workflows and design-time considerations, the onshape-robotics-toolkit library offers greater flexibility. It provides access to nearly all of Onshape's REST API calls, enabling headless manipulation, detailed analysis, and seamless export of CAD assemblies. Users can programmatically edit variable studios, generate graph-based visualizations, and export URDF files tailored to their specific needs—all without being restricted by rigid workflows or naming conventions. By removing these constraints, the onshape-robotics-toolkit library empowers the robotics and CAD communities to create custom solutions for algorithmic design, optimization, and automation.

 

Key Features of onshape-robotics-toolkit

The onshape-robotics-toolkit library is designed for users seeking a scalable, versatile API that empowers innovative robot design and control workflows. By integrating Onshape into algorithmic processes such as design optimization and automation, it unlocks the full potential of Onshape's cloud-based CAD system, fostering creativity and efficiency in robotics and beyond.

 

Feature	onshape-robotics-toolkit	onshape-to-robot
Workflow Flexibility	✅ Open-ended and customizable	❌ Predefined and rigid
Design-Time Considerations	✅ None	❌ Requires specific naming conventions
Custom URDF Workflow	✅ Supports any assembly	❌ Limited by design rules
Variable Studio Editing	✅ Yes	❌ No
Ease of Setup	❌ Moderate (requires python coding)	✅ Easy (no coding required)
Headless Integration	✅ Yes (e.g., optimization)	❌ No out-of-the-box support
Access to Full Onshape API	✅ Yes	❌ Limited
Graph Visualization and Analysis	✅ Supports graph generation	❌ Not supported

Prerequisites

Before you begin, ensure you have the following:

• Python 3.10 or higher installed on your machine.
• An Onshape account if you don't already have one.
• Onshape API keys (access key and secret key)

Note: Before using this tool (including making API calls or using it for research), ensure you have read and comply with Onshape's Terms of Use and be aware of Onshape's API limits and usage policies to avoid exceeding rate limits.

Installation

You can install onshape-robotics-toolkit using pip, which is the easiest way to install it and is the recommended method for most users.

pip install onshape-robotics-toolkit

If you want to install from source, you'll need to install uv and git first. Then, you can clone the repository and install the package.

git clone https://github.com/neurobionics/onshape-robotics-toolkit.git
cd onshape-robotics-toolkit
uv sync

Documentation

The documentation is available at https://neurobionics.github.io/onshape-robotics-toolkit/. It is generated using mkdocs and mkdocs-material and hosted on GitHub Pages.

Acknowledgements

This repository was created to facilitate an internal project at the RAI Institute; it was developed by Senthur Ayyappan and Elliott Rouse. We'd also like to acknowledge considerable support and guidance from Ben Bokser, Daniel Gonzalez, Surya Singh, Sangbae Kim, and Stelian Coros at the AI Institute.

Contributing

If you're interested in contributing to the project, please read the contributing guidelines to get started. All contributions are welcome!

License

This project is licensed under the Apache 2.0 License. For more information, please refer to the license file.

References

• Onshape API Documentation
• Onshape API Glassworks Explorer
• Onshape to Robot URDF Exporter