Skip to main content

solarian-arm1

solarian-arm1 is a 6-DOF arm module for Solarian. It is a modification of an existing open-source arm, the SO-100 by The Robot Studio. The mod adds one degree of freedom in the wrist, a yaw joint the original design does not have. Joints use Feetech STS servos (shoulder_pan, shoulder_lift, elbow_flex, wrist_flex, wrist_yaw, wrist_roll). The gripper is a separate module — typically solarian-gripper1, mated flange-to-flange.

Installation

pip install -e plugins/solarian-feetech
pip install -e plugins/solarian-arm1

Module

Entry point Class Role
arm-1 Arm1Module 6 joints + Mink IK (x..rz)

Default YAML lives at solarian_arm1/conf_arm.yaml. Copy it into a project's conf/ (for example right_arm.yaml) and set the serial port / servo ids.

from solarian.core.robot import Robot
from solarian.sim import SceneConfig, ModuleAttachment
from solarian_arm1 import ARM_MJCF_PATH
from solarian_arm1.arm import Arm1Module
from solarian_gripper1 import MJCF_FEETECH_PATH as GRIPPER_MJCF
from solarian_gripper1.gripper_feetech import Gripper1FeetechModule

class Arm1Robot(Robot):
    right_arm = Arm1Module(ik_tcp=Gripper1FeetechModule.tcp_from_flange)
    right_gripper = Gripper1FeetechModule()
    scene = SceneConfig(
        attachments=[
            ModuleAttachment(
                module="right_arm",
                mjcf=ARM_MJCF_PATH,
                prefix="right/",
            ),
            ModuleAttachment(
                module="right_gripper",
                mjcf=GRIPPER_MJCF,
                parent_site="right/flange",
                child_site="flange",
                prefix="right_gripper/",
            ),
        ],
    )

The arm MJCF exports a flange site (CAD Frame). Attach a gripper by aligning both models' flange frames. IK tracks flange plus the tool's tcp_from_flange offset (CAD tcp in the gripper's mate frame). The scene still attaches the gripper MJCF for physics and cameras.

Onshape export

Re-export after a CAD change (needs Onshape API credentials):

solarian onshape-export plugins/solarian-arm1/solarian_arm1/assets/arm1_description
solarian onshape-export plugins/solarian-arm1/solarian_arm1/assets/arm1_description --clean-only

That writes solarian_arm1/assets/arm1.xml. Use --update-yaml to sync joint limits into a project's arm config:

solarian onshape-export plugins/solarian-arm1/solarian_arm1/assets/arm1_description \
    --update-yaml projects/arm1/conf/modules/right_arm.yaml

CAD mates should be named shoulder_pan … wrist_roll. Keep a Frame named flange on the wrist for gripper attachment. Put the tool TCP Frame on the gripper assembly (name it tcp), not on the arm.

wrist_roll is 0-centered (±π) in arm1.xml / config.json even though CAD exports [-2π, 0]. solarian.prefer_config_limits keeps that override on re-export so home can roll both ways.

License

Apache License 2.0. Copyright 2026 PrimaryKey Inc. The mechanical design and meshes in solarian_arm1/assets/ are derived from the SO-ARM100 by The Robot Studio (Apache 2.0) and modified; see NOTICE. solarian-arm1 is not affiliated with, sponsored by, or endorsed by The Robot Studio or Hugging Face.

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

Metadata

Release files for solarian-arm1 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-arm1 0.2.0
File Size Uploaded Provenance Actions
solarian_arm1-0.2.0.tar.gz 3.4 MB With provenance Details for solarian_arm1-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 6.9 MB

Release files / solarian_arm1-0.2.0.tar.gz

Download URL solarian_arm1-0.2.0.tar.gz
Size 3.4 MB
Tags Source
SHA-256 checksum
How to use checksums
e16192e10fb4798d3220a84b62a593f90aeb3b2fc9cc6e91454ffa20f6e3b5a0
BLAKE2b-256 checksum
How to use checksums
1eed39e1e486ce65674ef2d064ce1edef991293d43d0d0813aa14b5cda20a27d
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_arm1-0.2.0-py3-none-any.whl

Download URL solarian_arm1-0.2.0-py3-none-any.whl
Size 3.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
c0cf28c54505d9ba9a5fa6a3a89ebeda4fd3e1a3dabb2dd2f50d7482253fca4d
BLAKE2b-256 checksum
How to use checksums
8fe931d3ef6eef37be0bc0208b275d9e1dc8f2791a9c91aee5467cc3f46c37fa
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-arm1 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_arm1-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