https://github.com/neurobionics/onshape-robotics-toolkit
A python library to facilitate interaction with Onshape's REST API
https://github.com/neurobionics/onshape-robotics-toolkit
cad control-systems mechanical-design onshape onshape-3d-cad onshape-api optimization python python3 robotics robotics-simulation
Last synced: about 1 month ago
JSON representation
A python library to facilitate interaction with Onshape's REST API
- Host: GitHub
- URL: https://github.com/neurobionics/onshape-robotics-toolkit
- Owner: neurobionics
- License: apache-2.0
- Created: 2024-09-29T21:18:11.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-25T12:58:40.000Z (4 months ago)
- Last Synced: 2025-05-07T17:14:28.378Z (about 2 months ago)
- Topics: cad, control-systems, mechanical-design, onshape, onshape-3d-cad, onshape-api, optimization, python, python3, robotics, robotics-simulation
- Language: Python
- Homepage: https://neurobionics.github.io/onshape-robotics-toolkit/
- Size: 14.6 MB
- Stars: 250
- Watchers: 7
- Forks: 21
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# onshape-robotics-toolkit
[](https://pypi.org/project/onshape-robotics-toolkit/)
[](https://github.com/neurobionics/onshape-robotics-toolkit/blob/main/LICENSE)
[](https://doi.org/10.5281/zenodo.14617407)
[](https://github.com/neurobionics/onshape-robotics-toolkit/blob/main/.pre-commit-config.yaml)
[](https://neurobionics.github.io/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)
## 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.
```sh
pip install onshape-robotics-toolkit
```
If you want to install from source, you'll need to install [`poetry`](https://python-poetry.org/docs/) and [`git`](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) first. Then, you can clone the repository and install the package.
```sh
git clone https://github.com/neurobionics/onshape-robotics-toolkit.git
cd onshape-robotics-toolkit
poetry install
```
## Documentation
The documentation is available at [https://neurobionics.github.io/onshape-robotics-toolkit/](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](https://rai-inst.com/); it was developed by [Senthur Ayyappan](https://senthurayyappan.github.io/) and [Elliott Rouse](https://neurobionics.robotics.umich.edu/). We'd also like to acknowledge considerable support and guidance from Ben Bokser, [Daniel Gonzalez](https://dgonzrobotics.com/), [Surya Singh](https://scholar.google.com/citations?user=ZDzQGPQAAAAJ&hl=en&oi=sra), Sangbae Kim, and Stelian Coros at the AI Institute.
## Contributing
If you're interested in contributing to the project, please read the [contributing guidelines](https://github.com/neurobionics/onshape-robotics-toolkit/blob/main/CONTRIBUTING.md) 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](https://github.com/neurobionics/onshape-robotics-toolkit/blob/main/LICENSE) file.
## References
- [Onshape API Documentation](https://onshape-public.github.io/docs/)
- [Onshape API Glassworks Explorer](https://cad.onshape.com/glassworks/explorer/#/)
- [Onshape to Robot URDF Exporter](https://github.com/Rhoban/onshape-to-robot)