Skip to main content

solarian-gripper1

A parallel gripper module for the Solarian framework. Two fingers, one actuator; you command it by the desired finger aperture in millimetres and the module handles the conversion for both real hardware and simulation.

The plugin ships two actuator variants that share the same finger kinematics and aperture command space:

Variant Module Default config MJCF
Feetech STS Gripper1FeetechModule conf_gripper_feetech.yaml assets/gripper1.xml
Robstride L7 Gripper1RobstrideModule conf_gripper_robstride.yaml assets/gripper1_robstride.xml

Installation

pip install solarian-gripper1             # Feetech variant
pip install "solarian-gripper1[hardware]" # plus the Feetech servo SDK, on the machine wired to the gripper

The Robstride variant needs solarian-robstride, which is not on PyPI yet. Install it from source alongside the gripper:

pip install -e "plugins/solarian-robstride[hardware]"
pip install -e "plugins/solarian-gripper1[robstride]"

How it works

  • Each module exposes a single actuator (gripper), matching the single physical servo. It converts an aperture command (mm) into the servo's normalized command space and writes that. Each backend maps normalized → physical:
    • Real: normalized → servo counts via the actuator calibration.
    • Sim: normalized → the left_manifold_to_rail prismatic joint via the sim: block in the variant's yaml.
  • Each MuJoCo model actuates only that one joint; an <equality> constraint (ratio −1, generated by onshape-to-robot from the CAD mate relation) drives the opposite finger, so one command opens/closes both jaws symmetrically.

Regenerating the sim model from Onshape

Each variant has its own CAD assembly (mates + limits + the linear finger relation). Re-export after a CAD change with:

# Feetech
solarian onshape-export plugins/solarian-gripper1/solarian_gripper1/assets/gripper1_description
solarian onshape-export plugins/solarian-gripper1/solarian_gripper1/assets/gripper1_description --clean-only

# Robstride
solarian onshape-export plugins/solarian-gripper1/solarian_gripper1/assets/gripper1_robstride_description
solarian onshape-export plugins/solarian-gripper1/solarian_gripper1/assets/gripper1_robstride_description --clean-only

The Feetech export writes solarian_gripper1/assets/gripper1.xml; the Robstride export writes solarian_gripper1/assets/gripper1_robstride.xml. The driven joint left_manifold_to_rail has range [0, 0.0545] m (0 = fingers apart / open, 0.0545 = fingers together / closed).

Using it in a robot

  1. Attach the model in your robot's sim SceneConfig, with a prefix matching the one in the gripper yaml (gripper/):
from solarian.sim import SceneConfig, ModuleAttachment
from solarian_gripper1 import MJCF_FEETECH_PATH as GRIPPER_MJCF
from solarian_gripper1.gripper_feetech import Gripper1FeetechModule

class MyRobot(Robot):
    is_sim = True
    gripper = Gripper1FeetechModule()

    scene = SceneConfig(
        attachments=[
            ModuleAttachment(
                module="gripper",
                # Loaded straight from the installed plugin (meshes resolve
                # relative to the MJCF) -- no need to copy the model into your
                # project, so there's a single source of truth.
                mjcf=GRIPPER_MJCF,
                parent_body="right/wrist_flange",   # the arm flange body
                prefix="gripper/",
            ),
        ],
    )

For the Robstride variant, import Gripper1RobstrideModule and MJCF_ROBSTRIDE_PATH instead. The Feetech MJCF attaches at the flange site; the Robstride MJCF attaches at the base site.

The Feetech MJCF exports CAD Frames as sites: flange (mate to the arm), camera (wrist lens), and tcp (tool center point). Pass Gripper1FeetechModule.tcp_from_flange to the arm as ik_tcp so IK tracks the flange plus that CAD offset.

Site-mate example (solarian-arm1 and this gripper both export a flange Frame):

ModuleAttachment(
    module="right_gripper",
    mjcf=GRIPPER_MJCF,
    parent_site="right/flange",
    child_site="flange",
    prefix="right_gripper/",
)
  1. Copy the matching yaml (conf_gripper_feetech.yaml or conf_gripper_robstride.yaml) into your project's conf/ and set the real port/id, then run solarian calibrate on the gripper: sweep the full closed↔open travel, then move to the fully closed pose when asked so drive_mode matches aperture_closed_mm / aperture_open_mm.

  2. Run solarian calibrate-gripper-ranges and read a ruler at each stop. This records aperture_table, the measured aperture curve. Skipping it leaves the module interpolating a straight line between the two endpoints, which the linkage does not follow.

  3. Command the gripper by aperture in mm — send a waypoint whose gripper value is the aperture (e.g. 85 = fully open, 0 = closed). Read the current aperture with module.read_aperture().

Configuration

Fields specific to both modules:

  • aperture_table — ruler-measured norm / aperture_mm pairs written by solarian calibrate-gripper-ranges. When present it defines the travel and the mm ↔ normalized map, superseding the two endpoint fields below.
  • aperture_closed_mm / aperture_open_mm — physical fingertip separation at the two ends of travel, used for a straight-line map until a table is measured. Keep them consistent with the servo calibration and the sim: joint range.
  • actuators.gripper.sim — maps the servo to gripper/left_manifold_to_rail, range_min: 0.0 / range_max: 0.0545 (the joint limits), drive_mode: 1 so normalized -100 = closed, 100 = open.
  • interpolator_type: scalar — GripperModule interpolates aperture in mm.

License

Apache License 2.0. Copyright 2026 PrimaryKey Inc. Parts of the mechanical design and meshes in solarian_gripper1/assets/ are derived from the UMI Gripper and UMI Soft Finger of the Universal Manipulation Interface (UMI) project, and the Robstride L7 drive from RobStride's EDULITE_A3 (MIT), and modified; see NOTICE. solarian-gripper1 is not affiliated with, sponsored by, or endorsed by UMI, its authors, Stanford University, Columbia University, Toyota Research Institute or RobStride.

Solarian and the Solarian logo are trademarks of PrimaryKey Inc. See the trademark policy.

Metadata

Release files for solarian-gripper1 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for solarian-gripper1 0.2.0
File Size Uploaded Provenance Actions
solarian_gripper1-0.2.0.tar.gz 3.1 MB With provenance Details for solarian_gripper1-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for solarian-gripper1 0.2.0
File Interpreter ABI Platform Actions
solarian_gripper1-0.2.0-py3-none-any.whl Python 3 none any Details for solarian_gripper1-0.2.0-py3-none-any.whl

Total release size: 6.1 MB

Release files / solarian_gripper1-0.2.0.tar.gz

Download URL solarian_gripper1-0.2.0.tar.gz
Size 3.1 MB
Tags Source
SHA-256 checksum
How to use checksums
a5098d775014de2f3088fcef46d464daf531107c618d32b9042b3271b2e8f6a0
BLAKE2b-256 checksum
How to use checksums
03fa0ee1bb1e8ae78da880228e91be4b372f0de512386db4287463bb618aa670
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / solarian_gripper1-0.2.0-py3-none-any.whl

Download URL solarian_gripper1-0.2.0-py3-none-any.whl
Size 3.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
93ea33dfd15b85405f6502e9881824876ab91c695997be01e7ebc2650a0ea4bd
BLAKE2b-256 checksum
How to use checksums
cb6342eefb09719b22fe6cebdb90ef94ad1051bb7adc527d258aee56248d677c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for solarian-gripper1 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for solarian_gripper1-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page